{
  "paths": {
    "/firms": {
      "post": {
        "operationId": "firms.create",
        "summary": "Préparer une structure pour son responsable",
        "description": "Avec le jeton propre à votre application (client credentials, scope `lexopti:firms`), jamais celui d'un membre : prépare la structure d'un nouveau client (une `firm`), qui attend son responsable, et LexOpti lui envoie le lien d'activation par e-mail (`claim_url`, dans cette seule réponse). Le responsable la réclame par l'inscription normale de LexOpti, où chaque vérification porte sur ce qu'il confirme (profession, conditions, essai ou paiement, code e-mail) ; alors seulement la structure existe dans LexOpti. Jusque-là, rien ne peut y être écrit. Seulement pour une application autorisée en production. Un SIREN déjà client de LexOpti répond 409 `firm_exists` : demandez au responsable de la structure d'inviter votre utilisateur. Exige une `Idempotency-Key` ; une nouvelle tentative avec la même répond la même structure sans son lien (`claim_url` null) : renouvelez le lien si vous en avez besoin.",
        "tags": [
          "Firms"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200,
                    "pattern": "^[^\\u0000-\\u001F\\u007F-\\u009F]*$",
                    "description": "Le nom de la structure, tel que son responsable le verra à l'inscription."
                  },
                  "siren": {
                    "type": "string",
                    "pattern": "^\\d{9}$",
                    "description": "Le SIREN de la structure : neuf chiffres avec une clé de contrôle valide."
                  },
                  "profession": {
                    "enum": [
                      "lawyer",
                      "real_estate",
                      "notary",
                      "accountant",
                      "other_regulated"
                    ],
                    "type": "string",
                    "description": "La profession réglementée de la structure. Son responsable la confirme à l'inscription, où LexOpti la vérifie comme pour toute structure."
                  },
                  "manager": {
                    "type": "object",
                    "properties": {
                      "email": {
                        "type": "string",
                        "maxLength": 254,
                        "format": "email",
                        "description": "L'adresse e-mail du responsable : LexOpti lui envoie le lien d'activation, et seul un compte à cette adresse peut réclamer la structure."
                      },
                      "first_name": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 100,
                        "pattern": "^[^\\u0000-\\u001F\\u007F-\\u009F]*$",
                        "description": "Le prénom du responsable, repris dans l'e-mail d'activation. Exemple : `Claire`."
                      },
                      "last_name": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 100,
                        "pattern": "^[^\\u0000-\\u001F\\u007F-\\u009F]*$",
                        "description": "Le nom du responsable, repris dans l'e-mail d'activation. Exemple : `Martin`."
                      }
                    },
                    "required": [
                      "email"
                    ],
                    "additionalProperties": false,
                    "description": "La personne qui réclamera la structure et en deviendra propriétaire."
                  },
                  "external_ref": {
                    "type": "string",
                    "pattern": "^[A-Za-z0-9:._-]{1,255}$",
                    "description": "Votre propre identifiant de la structure (un client de votre logiciel, par exemple `crm:customer:12`) : de 1 à 255 caractères parmi `A-Z a-z 0-9 : . _ -`, unique parmi vos structures encore en attente. Jamais une donnée personnelle."
                  },
                  "locale": {
                    "enum": [
                      "fr",
                      "en"
                    ],
                    "type": "string",
                    "default": "fr",
                    "description": "La langue de l'e-mail d'activation : `fr` sauf indication."
                  }
                },
                "required": [
                  "name",
                  "siren",
                  "profession",
                  "manager"
                ],
                "additionalProperties": false
              },
              "examples": {
                "an_accounting_firm": {
                  "summary": "Un cabinet d'expertise comptable",
                  "value": {
                    "name": "Martin Expertise",
                    "siren": "732829320",
                    "profession": "accountant",
                    "manager": {
                      "email": "direction@martin-expertise.example",
                      "first_name": "Claire",
                      "last_name": "Martin"
                    },
                    "external_ref": "crm:customer:12",
                    "locale": "fr"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "description": "`firm_` et 32 caractères hexadécimaux."
                    },
                    "status": {
                      "enum": [
                        "pending",
                        "claimed",
                        "expired",
                        "voided"
                      ],
                      "type": "string",
                      "description": "`pending` : attend son responsable ; `claimed` : le responsable s'est inscrit et la structure existe dans LexOpti ; `expired` : jamais réclamée à temps ; `voided` : une structure de ce SIREN a rejoint LexOpti autrement avant."
                    },
                    "name": {
                      "type": "string"
                    },
                    "siren": {
                      "type": "string"
                    },
                    "profession": {
                      "enum": [
                        "lawyer",
                        "real_estate",
                        "notary",
                        "accountant",
                        "other_regulated"
                      ],
                      "type": "string"
                    },
                    "external_ref": {
                      "anyOf": [
                        {
                          "type": "string",
                          "pattern": "^[A-Za-z0-9:._-]{1,255}$",
                          "description": "Votre propre identifiant de la structure (un client de votre logiciel, par exemple `crm:customer:12`) : de 1 à 255 caractères parmi `A-Z a-z 0-9 : . _ -`, unique parmi vos structures encore en attente. Jamais une donnée personnelle."
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Votre référence de la structure, null si vous n'en avez donné aucune."
                    },
                    "claim_url": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "uri"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Le lien d'activation : à usage unique, seulement dans la réponse qui l'a émis (la création et `POST /v1/firms/{id}/claim-link`), null partout ailleurs, une création rejouée comprise. Montrez-le au responsable connecté à votre logiciel si vous le souhaitez ; LexOpti le lui envoie par e-mail. Ne l'envoyez jamais vous-même à quelqu'un d'autre."
                    },
                    "claim_url_expires_at": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "date-time"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Quand le lien d'activation actuel cesse de fonctionner (7 jours au plus, jamais après `expires_at`) ; null dès que la structure n'est plus en attente."
                    },
                    "expires_at": {
                      "type": "string",
                      "format": "date-time",
                      "description": "Quand la structure expire si personne ne l'a réclamée (30 jours)."
                    },
                    "created_at": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "claimed_at": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "date-time"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "activated_at": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "date-time"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Quand l'offre de la structure réclamée a démarré (son essai ou son premier paiement)."
                    },
                    "organization_id": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "L'organisation créée par son responsable, une fois réclamée : l'`id` de `GET /v1/organization` dès qu'il autorise votre application."
                    }
                  },
                  "required": [
                    "id",
                    "status",
                    "name",
                    "siren",
                    "profession",
                    "external_ref",
                    "claim_url",
                    "claim_url_expires_at",
                    "expires_at",
                    "created_at",
                    "claimed_at",
                    "activated_at",
                    "organization_id"
                  ]
                }
              }
            },
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              },
              "RateLimit": {
                "description": "Requêtes restantes et secondes avant la réinitialisation de la fenêtre.",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Policy": {
                "description": "Requêtes autorisées par fenêtre, par application.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Requête invalide : `validation_failed` liste les champs invalides.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Jeton d'application absent, invalide ou expiré (`invalid_token`) : ces opérations prennent le jeton propre à votre application (client credentials), jamais celui d'un membre.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Le jeton n'a pas `lexopti:firms` (`insufficient_scope`), ou l'application n'est pas autorisée en production (`production_access_required`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Pas une structure préparée par votre application (`not_found`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Le SIREN est déjà client de LexOpti (`firm_exists` : demandez à son responsable d'inviter votre utilisateur), votre application a déjà une structure en attente pour ce SIREN (`firm_pending`) ou cette référence (`external_ref_conflict`), elle a trop de structures en attente (`too_many_pending_firms`, 50).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Cette `Idempotency-Key` a servi à une autre requête.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Limite de débit atteinte (`rate_limited`) ; réessayez après `Retry-After` secondes.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Erreur inattendue (`internal_error`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          }
        },
        "security": [
          {
            "oauth2Application": [
              "lexopti:firms"
            ]
          }
        ],
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Clé unique de cette requête (un UUID) : une nouvelle tentative avec la même clé et le même corps reçoit la première réponse.",
            "schema": {
              "type": "string",
              "maxLength": 255
            }
          }
        ],
        "x-codeSamples": [
          {
            "lang": "typescript",
            "label": "TypeScript",
            "source": "import { createLexOptiClient } from \"@lexopti/sdk\";\n\n// Your application's own token: client credentials, scope lexopti:firms.\nconst lexopti = createLexOptiClient({ accessToken: () => process.env.LEXOPTI_APP_TOKEN ?? \"\" });\n\nconst firm = await lexopti.firms.create({\n\tname: \"Agence du Port\",\n\tsiren: \"732829320\",\n\tprofession: \"real_estate\",\n\tmanager: {\n\t\temail: \"gerante@agence-du-port.example\",\n\t\tfirst_name: \"Claire\",\n\t\tlast_name: \"Martin\",\n\t},\n\texternal_ref: \"crm:agency:12\",\n\tlocale: \"fr\",\n});\n// LexOpti e-mails the claim link to the manager. Keep the firm's id:\n// `claim_url` is answered once, to show to the manager in your software.\nconsole.log(firm.id, firm.status, firm.expires_at);"
          },
          {
            "lang": "curl",
            "label": "curl",
            "source": "curl -X POST \"https://app.lexopti.com/v1/firms\" \\\n  -H \"Authorization: Bearer $LEXOPTI_APP_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Idempotency-Key: $(uuidgen)\" \\\n  -d '{\n    \"name\": \"Martin Expertise\",\n    \"siren\": \"732829320\",\n    \"profession\": \"accountant\",\n    \"manager\": {\n      \"email\": \"direction@martin-expertise.example\",\n      \"first_name\": \"Claire\",\n      \"last_name\": \"Martin\"\n    },\n    \"external_ref\": \"crm:customer:12\",\n    \"locale\": \"fr\"\n  }'"
          },
          {
            "lang": "php",
            "label": "PHP",
            "source": "$response = (new GuzzleHttp\\Client())->request('POST', 'https://app.lexopti.com/v1/firms', [\n    'headers' => ['Authorization' => 'Bearer ' . getenv('LEXOPTI_APP_TOKEN'), 'Idempotency-Key' => uniqid('', true)],\n    'json' => [\n        'name' => 'Martin Expertise',\n        'siren' => '732829320',\n        'profession' => 'accountant',\n        'manager' => [\n            'email' => 'direction@martin-expertise.example',\n            'first_name' => 'Claire',\n            'last_name' => 'Martin',\n        ],\n        'external_ref' => 'crm:customer:12',\n        'locale' => 'fr',\n    ],\n]);"
          }
        ]
      }
    },
    "/firms/{id}": {
      "get": {
        "operationId": "firms.get",
        "summary": "Lire une structure préparée",
        "description": "L'une des structures préparées par votre application (`firm`), avec son statut : interrogez-la pour savoir quand son responsable l'a réclamée, ou qu'elle a expiré ou été annulée. Jamais son lien d'activation.",
        "tags": [
          "Firms"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "L'identifiant LexOpti, tel que la création ou une liste l'a renvoyé (retrouvez un client ou un dossier par votre propre référence avec `?external_ref=`)."
            },
            "description": "L'identifiant LexOpti, tel que la création ou une liste l'a renvoyé (retrouvez un client ou un dossier par votre propre référence avec `?external_ref=`)."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "description": "`firm_` et 32 caractères hexadécimaux."
                    },
                    "status": {
                      "enum": [
                        "pending",
                        "claimed",
                        "expired",
                        "voided"
                      ],
                      "type": "string",
                      "description": "`pending` : attend son responsable ; `claimed` : le responsable s'est inscrit et la structure existe dans LexOpti ; `expired` : jamais réclamée à temps ; `voided` : une structure de ce SIREN a rejoint LexOpti autrement avant."
                    },
                    "name": {
                      "type": "string"
                    },
                    "siren": {
                      "type": "string"
                    },
                    "profession": {
                      "enum": [
                        "lawyer",
                        "real_estate",
                        "notary",
                        "accountant",
                        "other_regulated"
                      ],
                      "type": "string"
                    },
                    "external_ref": {
                      "anyOf": [
                        {
                          "type": "string",
                          "pattern": "^[A-Za-z0-9:._-]{1,255}$",
                          "description": "Votre propre identifiant de la structure (un client de votre logiciel, par exemple `crm:customer:12`) : de 1 à 255 caractères parmi `A-Z a-z 0-9 : . _ -`, unique parmi vos structures encore en attente. Jamais une donnée personnelle."
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Votre référence de la structure, null si vous n'en avez donné aucune."
                    },
                    "claim_url": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "uri"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Le lien d'activation : à usage unique, seulement dans la réponse qui l'a émis (la création et `POST /v1/firms/{id}/claim-link`), null partout ailleurs, une création rejouée comprise. Montrez-le au responsable connecté à votre logiciel si vous le souhaitez ; LexOpti le lui envoie par e-mail. Ne l'envoyez jamais vous-même à quelqu'un d'autre."
                    },
                    "claim_url_expires_at": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "date-time"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Quand le lien d'activation actuel cesse de fonctionner (7 jours au plus, jamais après `expires_at`) ; null dès que la structure n'est plus en attente."
                    },
                    "expires_at": {
                      "type": "string",
                      "format": "date-time",
                      "description": "Quand la structure expire si personne ne l'a réclamée (30 jours)."
                    },
                    "created_at": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "claimed_at": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "date-time"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "activated_at": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "date-time"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Quand l'offre de la structure réclamée a démarré (son essai ou son premier paiement)."
                    },
                    "organization_id": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "L'organisation créée par son responsable, une fois réclamée : l'`id` de `GET /v1/organization` dès qu'il autorise votre application."
                    }
                  },
                  "required": [
                    "id",
                    "status",
                    "name",
                    "siren",
                    "profession",
                    "external_ref",
                    "claim_url",
                    "claim_url_expires_at",
                    "expires_at",
                    "created_at",
                    "claimed_at",
                    "activated_at",
                    "organization_id"
                  ]
                }
              }
            },
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              },
              "RateLimit": {
                "description": "Requêtes restantes et secondes avant la réinitialisation de la fenêtre.",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Policy": {
                "description": "Requêtes autorisées par fenêtre, par application.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Requête invalide : `validation_failed` liste les champs invalides.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Jeton d'application absent, invalide ou expiré (`invalid_token`) : ces opérations prennent le jeton propre à votre application (client credentials), jamais celui d'un membre.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Le jeton n'a pas `lexopti:firms` (`insufficient_scope`), ou l'application n'est pas autorisée en production (`production_access_required`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Pas une structure préparée par votre application (`not_found`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Conflit : une requête avec la même `Idempotency-Key` est encore en cours.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Cette `Idempotency-Key` a servi à une autre requête.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Limite de débit atteinte (`rate_limited`) ; réessayez après `Retry-After` secondes.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Erreur inattendue (`internal_error`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          }
        },
        "security": [
          {
            "oauth2Application": [
              "lexopti:firms"
            ]
          }
        ],
        "x-codeSamples": [
          {
            "lang": "typescript",
            "label": "TypeScript",
            "source": "import { createLexOptiClient } from \"@lexopti/sdk\";\n\n// Your application's own token: client credentials, scope lexopti:firms.\nconst lexopti = createLexOptiClient({ accessToken: () => process.env.LEXOPTI_APP_TOKEN ?? \"\" });\n\nconst firm = await lexopti.firms.get({\n\tid: \"firm_7d3e9a1c5b2f4e6d8a0c1b3e5f7a9d2c\",\n});\nif (firm.status === \"claimed\") {\n\t// The organization the manager created: the one your OAuth connection names.\n\tconsole.log(firm.organization_id, firm.claimed_at);\n} else {\n\tconsole.log(firm.status, firm.expires_at);\n}"
          },
          {
            "lang": "curl",
            "label": "curl",
            "source": "curl -X GET \"https://app.lexopti.com/v1/firms/:id\" \\\n  -H \"Authorization: Bearer $LEXOPTI_APP_TOKEN\""
          },
          {
            "lang": "php",
            "label": "PHP",
            "source": "$response = (new GuzzleHttp\\Client())->request('GET', 'https://app.lexopti.com/v1/firms/:id', [\n    'headers' => ['Authorization' => 'Bearer ' . getenv('LEXOPTI_APP_TOKEN')],\n]);"
          }
        ]
      }
    },
    "/firms/{id}/claim-link": {
      "post": {
        "operationId": "firms.createClaimLink",
        "summary": "Renouveler un lien d'activation",
        "description": "Un nouveau lien d'activation pour une structure encore en attente, de nouveau envoyé par e-mail à son responsable, une fois par minute au plus (429 `rate_limited`) : le lien précédent cesse aussitôt de fonctionner. Pour un lien expiré (7 jours) ou perdu. 409 `firm_not_pending` dès que la structure est réclamée, expirée ou annulée.",
        "tags": [
          "Firms"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "L'identifiant LexOpti, tel que la création ou une liste l'a renvoyé (retrouvez un client ou un dossier par votre propre référence avec `?external_ref=`)."
            },
            "description": "L'identifiant LexOpti, tel que la création ou une liste l'a renvoyé (retrouvez un client ou un dossier par votre propre référence avec `?external_ref=`)."
          }
        ],
        "responses": {
          "201": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "description": "`firm_` et 32 caractères hexadécimaux."
                    },
                    "status": {
                      "enum": [
                        "pending",
                        "claimed",
                        "expired",
                        "voided"
                      ],
                      "type": "string",
                      "description": "`pending` : attend son responsable ; `claimed` : le responsable s'est inscrit et la structure existe dans LexOpti ; `expired` : jamais réclamée à temps ; `voided` : une structure de ce SIREN a rejoint LexOpti autrement avant."
                    },
                    "name": {
                      "type": "string"
                    },
                    "siren": {
                      "type": "string"
                    },
                    "profession": {
                      "enum": [
                        "lawyer",
                        "real_estate",
                        "notary",
                        "accountant",
                        "other_regulated"
                      ],
                      "type": "string"
                    },
                    "external_ref": {
                      "anyOf": [
                        {
                          "type": "string",
                          "pattern": "^[A-Za-z0-9:._-]{1,255}$",
                          "description": "Votre propre identifiant de la structure (un client de votre logiciel, par exemple `crm:customer:12`) : de 1 à 255 caractères parmi `A-Z a-z 0-9 : . _ -`, unique parmi vos structures encore en attente. Jamais une donnée personnelle."
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Votre référence de la structure, null si vous n'en avez donné aucune."
                    },
                    "claim_url": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "uri"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Le lien d'activation : à usage unique, seulement dans la réponse qui l'a émis (la création et `POST /v1/firms/{id}/claim-link`), null partout ailleurs, une création rejouée comprise. Montrez-le au responsable connecté à votre logiciel si vous le souhaitez ; LexOpti le lui envoie par e-mail. Ne l'envoyez jamais vous-même à quelqu'un d'autre."
                    },
                    "claim_url_expires_at": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "date-time"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Quand le lien d'activation actuel cesse de fonctionner (7 jours au plus, jamais après `expires_at`) ; null dès que la structure n'est plus en attente."
                    },
                    "expires_at": {
                      "type": "string",
                      "format": "date-time",
                      "description": "Quand la structure expire si personne ne l'a réclamée (30 jours)."
                    },
                    "created_at": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "claimed_at": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "date-time"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "activated_at": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "date-time"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Quand l'offre de la structure réclamée a démarré (son essai ou son premier paiement)."
                    },
                    "organization_id": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "L'organisation créée par son responsable, une fois réclamée : l'`id` de `GET /v1/organization` dès qu'il autorise votre application."
                    }
                  },
                  "required": [
                    "id",
                    "status",
                    "name",
                    "siren",
                    "profession",
                    "external_ref",
                    "claim_url",
                    "claim_url_expires_at",
                    "expires_at",
                    "created_at",
                    "claimed_at",
                    "activated_at",
                    "organization_id"
                  ]
                }
              }
            },
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              },
              "RateLimit": {
                "description": "Requêtes restantes et secondes avant la réinitialisation de la fenêtre.",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Policy": {
                "description": "Requêtes autorisées par fenêtre, par application.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Requête invalide : `validation_failed` liste les champs invalides.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Jeton d'application absent, invalide ou expiré (`invalid_token`) : ces opérations prennent le jeton propre à votre application (client credentials), jamais celui d'un membre.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Le jeton n'a pas `lexopti:firms` (`insufficient_scope`), ou l'application n'est pas autorisée en production (`production_access_required`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Pas une structure préparée par votre application (`not_found`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "La structure n'est plus en attente : réclamée, expirée ou annulée (`firm_not_pending`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Cette `Idempotency-Key` a servi à une autre requête.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Limite de débit atteinte (`rate_limited`) ; réessayez après `Retry-After` secondes.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Erreur inattendue (`internal_error`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          }
        },
        "security": [
          {
            "oauth2Application": [
              "lexopti:firms"
            ]
          }
        ],
        "x-codeSamples": [
          {
            "lang": "typescript",
            "label": "TypeScript",
            "source": "import { createLexOptiClient } from \"@lexopti/sdk\";\n\n// Your application's own token: client credentials, scope lexopti:firms.\nconst lexopti = createLexOptiClient({ accessToken: () => process.env.LEXOPTI_APP_TOKEN ?? \"\" });\n\nconst firm = await lexopti.firms.createClaimLink({\n\tid: \"firm_7d3e9a1c5b2f4e6d8a0c1b3e5f7a9d2c\",\n});\n// The previous link stopped working; this one lasts until claim_url_expires_at.\nconsole.log(firm.status, firm.claim_url_expires_at);"
          },
          {
            "lang": "curl",
            "label": "curl",
            "source": "curl -X POST \"https://app.lexopti.com/v1/firms/:id/claim-link\" \\\n  -H \"Authorization: Bearer $LEXOPTI_APP_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Idempotency-Key: $(uuidgen)\" \\\n  -d '{}'"
          },
          {
            "lang": "php",
            "label": "PHP",
            "source": "$response = (new GuzzleHttp\\Client())->request('POST', 'https://app.lexopti.com/v1/firms/:id/claim-link', [\n    'headers' => ['Authorization' => 'Bearer ' . getenv('LEXOPTI_APP_TOKEN'), 'Idempotency-Key' => uniqid('', true)],\n    'json' => [],\n]);"
          }
        ]
      }
    },
    "/embed-sessions": {
      "post": {
        "operationId": "embedSessions.create",
        "summary": "Ouvrir une session embarquée",
        "description": "Un code à usage unique (60 s) pour les composants embarqués, pour le membre du jeton d'accès et une origine de page partenaire enregistrée pour l'application. Appelez-le depuis votre serveur ; les composants échangent le code contre leur propre jeton de courte durée.",
        "tags": [
          "Embedded UI"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "code_challenge": {
                    "type": "string",
                    "pattern": "^[\\w-]{43}$",
                    "description": "Le défi PKCE que les composants embarqués ont remis à votre page (`codeChallenge` du `sessionProvider`), transmis tel quel : seule l'iframe qui l'a créé peut échanger le code."
                  },
                  "code_challenge_method": {
                    "const": "S256",
                    "description": "Toujours `S256` (`codeChallengeMethod` du `sessionProvider`)."
                  },
                  "component": {
                    "enum": [
                      "app",
                      "client",
                      "case",
                      "clients",
                      "cases",
                      "new-client",
                      "new-case",
                      "classification"
                    ],
                    "type": "string",
                    "description": "Le composant que la session ouvre (`component` du `sessionProvider`), transmis tel quel. Disponibles : `client`, `case`, `clients`, `cases`, `app`, `new-client`, `new-case` et `classification` (le questionnaire d'un client ou d'un dossier, nu)."
                  },
                  "features": {
                    "type": "array",
                    "maxItems": 16,
                    "items": {
                      "type": "string",
                      "maxLength": 32
                    },
                    "description": "Les parties du composant à garder, toutes si le champ est omis ; les droits du membre s'appliquent toujours. `client` et `clients` : `monitoring`, `cases`, `classification`, `informations`, `comments`, `activity`, `launch-check`, `edit`. `case` et `cases` : `parties`, `tracfin2` (the risk questionnaire), `documents`, `comments`, `activity`, `launch-check`, `edit`. `app` : les onglets des deux fiches, puis `launch-check` et `edit`. `edit` porte aussi les entrées de création des listes et du tableau de bord. Une clé d'un autre composant répond `invalid_features`."
                  },
                  "origin": {
                    "type": "string",
                    "description": "Origine de la page partenaire qui embarque les composants (`https://crm.example.com`), enregistrée pour l'application."
                  }
                },
                "required": [
                  "code_challenge",
                  "code_challenge_method",
                  "component",
                  "origin"
                ]
              },
              "examples": {
                "the_client_component": {
                  "summary": "Le composant client",
                  "value": {
                    "code_challenge": "E9Melhoa2OwvFrEMTJguCHaoeK1t8URWbuGJSstw-cM",
                    "code_challenge_method": "S256",
                    "component": "client",
                    "origin": "https://crm.example.com"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "string",
                      "description": "Code à usage unique pour les composants embarqués ; transmettez-le aussitôt, ne le stockez jamais."
                    },
                    "expires_at": {
                      "type": "string",
                      "format": "date-time",
                      "description": "60 secondes après sa délivrance."
                    },
                    "integration": {
                      "type": "string",
                      "description": "L'identifiant public de l'application, pour l'attribut `integration` des composants."
                    }
                  },
                  "required": [
                    "code",
                    "expires_at",
                    "integration"
                  ]
                }
              }
            },
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              },
              "RateLimit": {
                "description": "Requêtes restantes et secondes avant la réinitialisation de la fenêtre.",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Policy": {
                "description": "Requêtes autorisées par fenêtre, par application.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Requête invalide : `validation_failed` liste les champs invalides.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Jeton absent, invalide ou expiré, ou accès du membre à l'application terminé (`invalid_token`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Portée manquante (`insufficient_scope`), membre en lecture seule (`readonly_member`), ou action que l'abonnement de l'organisation refuse.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Introuvable dans l'organisation à laquelle le jeton est lié (`not_found`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Conflit : une requête avec la même `Idempotency-Key` est encore en cours.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Cette `Idempotency-Key` a servi à une autre requête.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Limite de débit atteinte (`rate_limited`) ; réessayez après `Retry-After` secondes.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Erreur inattendue (`internal_error`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          }
        },
        "security": [
          {
            "oauth2": [
              "lexopti:write"
            ]
          }
        ],
        "x-codeSamples": [
          {
            "lang": "typescript",
            "label": "TypeScript",
            "source": "import { createLexOptiClient } from \"@lexopti/sdk\";\n\nconst lexopti = createLexOptiClient({ accessToken: () => process.env.LEXOPTI_TOKEN ?? \"\" });\n\n// The challenge and the component the element handed your page\n// (sessionProvider), as is.\nconst codeChallenge = \"E9Melhoa2OwvFrEMTJguCHaoeK1t8URWbuGJSstw-cM\";\nconst session = await lexopti.embedSessions.create({\n\tcode_challenge: codeChallenge,\n\tcode_challenge_method: \"S256\",\n\tcomponent: \"client\",\n\torigin: \"https://crm.example.com\",\n});\nconsole.log(session.code, session.integration);"
          },
          {
            "lang": "curl",
            "label": "curl",
            "source": "curl -X POST \"https://app.lexopti.com/v1/embed-sessions\" \\\n  -H \"Authorization: Bearer $LEXOPTI_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Idempotency-Key: $(uuidgen)\" \\\n  -d '{\n    \"code_challenge\": \"E9Melhoa2OwvFrEMTJguCHaoeK1t8URWbuGJSstw-cM\",\n    \"code_challenge_method\": \"S256\",\n    \"component\": \"client\",\n    \"origin\": \"https://crm.example.com\"\n  }'"
          },
          {
            "lang": "php",
            "label": "PHP",
            "source": "$response = (new GuzzleHttp\\Client())->request('POST', 'https://app.lexopti.com/v1/embed-sessions', [\n    'headers' => ['Authorization' => 'Bearer ' . getenv('LEXOPTI_TOKEN'), 'Idempotency-Key' => uniqid('', true)],\n    'json' => [\n        'code_challenge' => 'E9Melhoa2OwvFrEMTJguCHaoeK1t8URWbuGJSstw-cM',\n        'code_challenge_method' => 'S256',\n        'component' => 'client',\n        'origin' => 'https://crm.example.com',\n    ],\n]);"
          }
        ]
      }
    },
    "/events": {
      "get": {
        "operationId": "events.list",
        "summary": "Lister les événements",
        "description": "Les événements de l'organisation, du plus récent au plus ancien, identiques à ceux des webhooks. Pour les intégrations qui interrogent l'API ; dédoublonnez sur `id`.",
        "tags": [
          "Events"
        ],
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 25,
              "description": "Taille de page, de 1 à 100."
            },
            "allowEmptyValue": true,
            "allowReserved": true,
            "description": "Taille de page, de 1 à 100."
          },
          {
            "name": "cursor",
            "in": "query",
            "schema": {
              "type": "string",
              "description": "`next_cursor` de la page précédente ; à omettre pour la première page."
            },
            "allowEmptyValue": true,
            "allowReserved": true,
            "description": "`next_cursor` de la page précédente ; à omettre pour la première page."
          },
          {
            "name": "type",
            "in": "query",
            "schema": {
              "x-extensible-enum": [
                "check.completed",
                "check.failed",
                "client.created",
                "client.updated",
                "client.vigilance_level_changed",
                "client.risk_level_changed",
                "client.preliminary_screening_completed",
                "classification.validated",
                "case.created",
                "case.updated",
                "case.risk_level_changed",
                "report.generated",
                "alert.created",
                "alert.resolved",
                "decision.pending",
                "quota.exhausted",
                "subscription.inactive",
                "access.revoked",
                "member.enrolled",
                "member.joined"
              ],
              "type": "string",
              "description": "Un des types d'événement du catalogue (la section `webhooks` de ce document). De nouveaux types peuvent s'ajouter : ignorez ceux que vous ne traitez pas."
            },
            "allowEmptyValue": true,
            "allowReserved": true,
            "description": "Un des types d'événement du catalogue (la section `webhooks` de ce document). De nouveaux types peuvent s'ajouter : ignorez ceux que vous ne traitez pas."
          },
          {
            "name": "after",
            "in": "query",
            "schema": {
              "type": "string",
              "pattern": "^(?:0|\\d+\\.\\d+)$",
              "description": "Interrogation périodique : les événements après cette `position` (`0` depuis le début), du plus ancien au plus récent. Gardez la dernière `position` lue et renvoyez-la la fois suivante : aucun événement ne peut apparaître plus tard avant elle, vous n'en manquez donc aucun. Sans elle, du plus récent au plus ancien avec `cursor`."
            },
            "allowEmptyValue": true,
            "allowReserved": true,
            "description": "Interrogation périodique : les événements après cette `position` (`0` depuis le début), du plus ancien au plus récent. Gardez la dernière `position` lue et renvoyez-la la fois suivante : aucun événement ne peut apparaître plus tard avant elle, vous n'en manquez donc aucun. Sans elle, du plus récent au plus ancien avec `cursor`."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Event"
                      }
                    },
                    "has_more": {
                      "type": "boolean"
                    },
                    "next_cursor": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "À passer en `cursor` pour lire la page suivante ; null sur la dernière."
                    }
                  },
                  "required": [
                    "data",
                    "has_more",
                    "next_cursor"
                  ]
                }
              }
            },
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              },
              "RateLimit": {
                "description": "Requêtes restantes et secondes avant la réinitialisation de la fenêtre.",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Policy": {
                "description": "Requêtes autorisées par fenêtre, par application.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Requête invalide : `validation_failed` liste les champs invalides.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Jeton absent, invalide ou expiré, ou accès du membre à l'application terminé (`invalid_token`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Portée manquante (`insufficient_scope`), membre en lecture seule (`readonly_member`), ou action que l'abonnement de l'organisation refuse.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Introuvable dans l'organisation à laquelle le jeton est lié (`not_found`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Conflit : une requête avec la même `Idempotency-Key` est encore en cours.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Cette `Idempotency-Key` a servi à une autre requête.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Limite de débit atteinte (`rate_limited`) ; réessayez après `Retry-After` secondes.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Erreur inattendue (`internal_error`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          }
        },
        "security": [
          {
            "oauth2": [
              "lexopti:read"
            ]
          }
        ],
        "x-codeSamples": [
          {
            "lang": "typescript",
            "label": "TypeScript",
            "source": "import { createLexOptiClient } from \"@lexopti/sdk\";\n\nconst lexopti = createLexOptiClient({ accessToken: () => process.env.LEXOPTI_TOKEN ?? \"\" });\n\nconst page = await lexopti.events.list({ limit: 100 });\nfor (const event of page.data) {\n\tconsole.log(event.position, event.type, event.data);\n}"
          },
          {
            "lang": "curl",
            "label": "curl",
            "source": "curl -X GET \"https://app.lexopti.com/v1/events\" \\\n  -H \"Authorization: Bearer $LEXOPTI_TOKEN\""
          },
          {
            "lang": "php",
            "label": "PHP",
            "source": "$response = (new GuzzleHttp\\Client())->request('GET', 'https://app.lexopti.com/v1/events', [\n    'headers' => ['Authorization' => 'Bearer ' . getenv('LEXOPTI_TOKEN')],\n]);"
          }
        ]
      }
    },
    "/alerts": {
      "get": {
        "operationId": "alerts.list",
        "summary": "Lister les alertes",
        "description": "Les alertes de l'organisation, de la plus récente à la plus ancienne.",
        "tags": [
          "Alerts"
        ],
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 25,
              "description": "Taille de page, de 1 à 100."
            },
            "allowEmptyValue": true,
            "allowReserved": true,
            "description": "Taille de page, de 1 à 100."
          },
          {
            "name": "cursor",
            "in": "query",
            "schema": {
              "type": "string",
              "description": "`next_cursor` de la page précédente ; à omettre pour la première page."
            },
            "allowEmptyValue": true,
            "allowReserved": true,
            "description": "`next_cursor` de la page précédente ; à omettre pour la première page."
          },
          {
            "name": "client_id",
            "in": "query",
            "schema": {
              "type": "string",
              "description": "Seulement les alertes de ce client."
            },
            "allowEmptyValue": true,
            "allowReserved": true,
            "description": "Seulement les alertes de ce client."
          },
          {
            "name": "client_ids",
            "in": "query",
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{1,64}(?:,[A-Za-z0-9_-]{1,64}){0,99}$",
              "description": "Seulement les alertes de ces clients, par leur identifiant LexOpti, séparés par des virgules (100 au plus), comme `GET /v1/clients?ids=` les prend : une requête pour les alertes d'une page de fiches. Un client d'une autre organisation est ignoré, comme un inconnu."
            },
            "allowEmptyValue": true,
            "allowReserved": true,
            "description": "Seulement les alertes de ces clients, par leur identifiant LexOpti, séparés par des virgules (100 au plus), comme `GET /v1/clients?ids=` les prend : une requête pour les alertes d'une page de fiches. Un client d'une autre organisation est ignoré, comme un inconnu."
          },
          {
            "name": "status",
            "in": "query",
            "schema": {
              "enum": [
                "pending",
                "reviewed",
                "dismissed",
                "confirmed"
              ],
              "type": "string",
              "description": "`pending` jusqu'à l'examen ; `reviewed` (pris en compte), `dismissed` (écarté) ou `confirmed` (risque confirmé)."
            },
            "allowEmptyValue": true,
            "allowReserved": true,
            "description": "`pending` jusqu'à l'examen ; `reviewed` (pris en compte), `dismissed` (écarté) ou `confirmed` (risque confirmé)."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Alert"
                      }
                    },
                    "has_more": {
                      "type": "boolean"
                    },
                    "next_cursor": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "À passer en `cursor` pour lire la page suivante ; null sur la dernière."
                    }
                  },
                  "required": [
                    "data",
                    "has_more",
                    "next_cursor"
                  ]
                }
              }
            },
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              },
              "RateLimit": {
                "description": "Requêtes restantes et secondes avant la réinitialisation de la fenêtre.",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Policy": {
                "description": "Requêtes autorisées par fenêtre, par application.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Requête invalide : `validation_failed` liste les champs invalides.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Jeton absent, invalide ou expiré, ou accès du membre à l'application terminé (`invalid_token`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Portée manquante (`insufficient_scope`), membre en lecture seule (`readonly_member`), ou action que l'abonnement de l'organisation refuse.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Introuvable dans l'organisation à laquelle le jeton est lié (`not_found`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Conflit : une requête avec la même `Idempotency-Key` est encore en cours.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Cette `Idempotency-Key` a servi à une autre requête.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Limite de débit atteinte (`rate_limited`) ; réessayez après `Retry-After` secondes.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Erreur inattendue (`internal_error`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          }
        },
        "security": [
          {
            "oauth2": [
              "lexopti:read"
            ]
          }
        ],
        "x-codeSamples": [
          {
            "lang": "typescript",
            "label": "TypeScript",
            "source": "import { createLexOptiClient } from \"@lexopti/sdk\";\n\nconst lexopti = createLexOptiClient({ accessToken: () => process.env.LEXOPTI_TOKEN ?? \"\" });\n\nconst page = await lexopti.alerts.list({\n\tclient_id: \"6f1b8d6e-2c4a-4f5e-9b1d-3a7c2e8f4d10\",\n\tstatus: \"pending\",\n\tlimit: 50,\n});\nfor (const alert of page.data) {\n\tconsole.log(alert.id, alert.level, alert.subject);\n}"
          },
          {
            "lang": "curl",
            "label": "curl",
            "source": "curl -X GET \"https://app.lexopti.com/v1/alerts\" \\\n  -H \"Authorization: Bearer $LEXOPTI_TOKEN\""
          },
          {
            "lang": "php",
            "label": "PHP",
            "source": "$response = (new GuzzleHttp\\Client())->request('GET', 'https://app.lexopti.com/v1/alerts', [\n    'headers' => ['Authorization' => 'Bearer ' . getenv('LEXOPTI_TOKEN')],\n]);"
          }
        ]
      }
    },
    "/alerts/{id}": {
      "get": {
        "operationId": "alerts.get",
        "summary": "Lire une alerte",
        "description": "Une alerte de l'organisation, avec sa source et son examen.",
        "tags": [
          "Alerts"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "L'identifiant LexOpti, tel que la création ou une liste l'a renvoyé (retrouvez un client ou un dossier par votre propre référence avec `?external_ref=`)."
            },
            "description": "L'identifiant LexOpti, tel que la création ou une liste l'a renvoyé (retrouvez un client ou un dossier par votre propre référence avec `?external_ref=`)."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Alert"
                }
              }
            },
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              },
              "RateLimit": {
                "description": "Requêtes restantes et secondes avant la réinitialisation de la fenêtre.",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Policy": {
                "description": "Requêtes autorisées par fenêtre, par application.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Requête invalide : `validation_failed` liste les champs invalides.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Jeton absent, invalide ou expiré, ou accès du membre à l'application terminé (`invalid_token`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Portée manquante (`insufficient_scope`), membre en lecture seule (`readonly_member`), ou action que l'abonnement de l'organisation refuse.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Introuvable dans l'organisation à laquelle le jeton est lié (`not_found`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Conflit : une requête avec la même `Idempotency-Key` est encore en cours.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Cette `Idempotency-Key` a servi à une autre requête.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Limite de débit atteinte (`rate_limited`) ; réessayez après `Retry-After` secondes.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Erreur inattendue (`internal_error`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          }
        },
        "security": [
          {
            "oauth2": [
              "lexopti:read"
            ]
          }
        ],
        "x-codeSamples": [
          {
            "lang": "typescript",
            "label": "TypeScript",
            "source": "import { createLexOptiClient } from \"@lexopti/sdk\";\n\nconst lexopti = createLexOptiClient({ accessToken: () => process.env.LEXOPTI_TOKEN ?? \"\" });\n\nconst alert = await lexopti.alerts.get({\n\tid: \"a3d5f7b9-1c2e-4f60-8a9b-7c6d5e4f3a21\",\n});\nconsole.log(alert.level, alert.source, alert.status);"
          },
          {
            "lang": "curl",
            "label": "curl",
            "source": "curl -X GET \"https://app.lexopti.com/v1/alerts/:id\" \\\n  -H \"Authorization: Bearer $LEXOPTI_TOKEN\""
          },
          {
            "lang": "php",
            "label": "PHP",
            "source": "$response = (new GuzzleHttp\\Client())->request('GET', 'https://app.lexopti.com/v1/alerts/:id', [\n    'headers' => ['Authorization' => 'Bearer ' . getenv('LEXOPTI_TOKEN')],\n]);"
          }
        ]
      },
      "patch": {
        "operationId": "alerts.update",
        "summary": "Examiner une alerte",
        "description": "Enregistre l'examen du membre, comme dans l'application. La décision reste celle du membre : l'API n'examine jamais d'elle-même.",
        "tags": [
          "Alerts"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "L'identifiant LexOpti, tel que la création ou une liste l'a renvoyé (retrouvez un client ou un dossier par votre propre référence avec `?external_ref=`)."
            },
            "description": "L'identifiant LexOpti, tel que la création ou une liste l'a renvoyé (retrouvez un client ou un dossier par votre propre référence avec `?external_ref=`)."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "status": {
                    "enum": [
                      "reviewed",
                      "dismissed",
                      "confirmed"
                    ],
                    "type": "string",
                    "description": "L'examen du membre : `reviewed` (prise en compte), `dismissed` (non pertinente, par exemple un homonyme) ou `confirmed` (risque confirmé)."
                  },
                  "notes": {
                    "type": "string",
                    "maxLength": 2000,
                    "description": "La note du membre sur son examen, visible dans LexOpti. 2 000 caractères au plus."
                  }
                },
                "required": [
                  "status"
                ]
              },
              "examples": {
                "dismiss_a_homonym": {
                  "summary": "Écarter un homonyme",
                  "value": {
                    "status": "dismissed",
                    "notes": "Homonym: different date of birth."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Alert"
                }
              }
            },
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              },
              "RateLimit": {
                "description": "Requêtes restantes et secondes avant la réinitialisation de la fenêtre.",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Policy": {
                "description": "Requêtes autorisées par fenêtre, par application.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Requête invalide : `validation_failed` liste les champs invalides.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Jeton absent, invalide ou expiré, ou accès du membre à l'application terminé (`invalid_token`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Portée manquante (`insufficient_scope`), membre en lecture seule (`readonly_member`), ou action que l'abonnement de l'organisation refuse.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Introuvable dans l'organisation à laquelle le jeton est lié (`not_found`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Conflit : une requête avec la même `Idempotency-Key` est encore en cours.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Cette `Idempotency-Key` a servi à une autre requête.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Limite de débit atteinte (`rate_limited`) ; réessayez après `Retry-After` secondes.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Erreur inattendue (`internal_error`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          }
        },
        "security": [
          {
            "oauth2": [
              "lexopti:write"
            ]
          }
        ],
        "x-codeSamples": [
          {
            "lang": "typescript",
            "label": "TypeScript",
            "source": "import { createLexOptiClient } from \"@lexopti/sdk\";\n\nconst lexopti = createLexOptiClient({ accessToken: () => process.env.LEXOPTI_TOKEN ?? \"\" });\n\nconst alert = await lexopti.alerts.update({\n\tid: \"a3d5f7b9-1c2e-4f60-8a9b-7c6d5e4f3a21\",\n\tstatus: \"dismissed\",\n\tnotes: \"Homonym: different date of birth.\",\n});\nconsole.log(alert.status, alert.reviewed_at);"
          },
          {
            "lang": "curl",
            "label": "curl",
            "source": "curl -X PATCH \"https://app.lexopti.com/v1/alerts/:id\" \\\n  -H \"Authorization: Bearer $LEXOPTI_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Idempotency-Key: $(uuidgen)\" \\\n  -d '{\n    \"status\": \"dismissed\",\n    \"notes\": \"Homonym: different date of birth.\"\n  }'"
          },
          {
            "lang": "php",
            "label": "PHP",
            "source": "$response = (new GuzzleHttp\\Client())->request('PATCH', 'https://app.lexopti.com/v1/alerts/:id', [\n    'headers' => ['Authorization' => 'Bearer ' . getenv('LEXOPTI_TOKEN'), 'Idempotency-Key' => uniqid('', true)],\n    'json' => [\n        'status' => 'dismissed',\n        'notes' => 'Homonym: different date of birth.',\n    ],\n]);"
          }
        ]
      }
    },
    "/cases": {
      "get": {
        "operationId": "cases.list",
        "summary": "Lister les dossiers",
        "description": "Les dossiers de l'organisation, du plus récent au plus ancien.",
        "tags": [
          "Cases"
        ],
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 25,
              "description": "Taille de page, de 1 à 100."
            },
            "allowEmptyValue": true,
            "allowReserved": true,
            "description": "Taille de page, de 1 à 100."
          },
          {
            "name": "cursor",
            "in": "query",
            "schema": {
              "type": "string",
              "description": "`next_cursor` de la page précédente ; à omettre pour la première page."
            },
            "allowEmptyValue": true,
            "allowReserved": true,
            "description": "`next_cursor` de la page précédente ; à omettre pour la première page."
          },
          {
            "name": "external_ref",
            "in": "query",
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9:._-]{1,255}(?:,[A-Za-z0-9:._-]{1,255}){0,99}$",
              "description": "Seulement les dossiers portant ces références de votre application, séparées par des virgules (100 au plus) : `crm:matter:1,crm:matter:2`. Une référence inconnue est ignorée ; aucune connue donne une page vide."
            },
            "allowEmptyValue": true,
            "allowReserved": true,
            "description": "Seulement les dossiers portant ces références de votre application, séparées par des virgules (100 au plus) : `crm:matter:1,crm:matter:2`. Une référence inconnue est ignorée ; aucune connue donne une page vide."
          },
          {
            "name": "ids",
            "in": "query",
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{1,64}(?:,[A-Za-z0-9_-]{1,64}){0,99}$",
              "description": "Seulement ces dossiers, par leur identifiant LexOpti, séparées par des virgules (100 au plus). Un identifiant d'une autre organisation est ignoré, comme un inconnu."
            },
            "allowEmptyValue": true,
            "allowReserved": true,
            "description": "Seulement ces dossiers, par leur identifiant LexOpti, séparées par des virgules (100 au plus). Un identifiant d'une autre organisation est ignoré, comme un inconnu."
          },
          {
            "name": "client_id",
            "in": "query",
            "schema": {
              "type": "string",
              "description": "Seulement les dossiers de ce client, principal ou non."
            },
            "allowEmptyValue": true,
            "allowReserved": true,
            "description": "Seulement les dossiers de ce client, principal ou non."
          },
          {
            "name": "party_external_ref",
            "in": "query",
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9:._-]{1,255}$",
              "description": "Seulement les dossiers dont cette partie est (votre référence de la personne ou de la société) ; une référence inconnue donne une page vide."
            },
            "allowEmptyValue": true,
            "allowReserved": true,
            "description": "Seulement les dossiers dont cette partie est (votre référence de la personne ou de la société) ; une référence inconnue donne une page vide."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Case"
                      }
                    },
                    "has_more": {
                      "type": "boolean"
                    },
                    "next_cursor": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "À passer en `cursor` pour lire la page suivante ; null sur la dernière."
                    }
                  },
                  "required": [
                    "data",
                    "has_more",
                    "next_cursor"
                  ]
                }
              }
            },
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              },
              "RateLimit": {
                "description": "Requêtes restantes et secondes avant la réinitialisation de la fenêtre.",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Policy": {
                "description": "Requêtes autorisées par fenêtre, par application.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Requête invalide : `validation_failed` liste les champs invalides.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Jeton absent, invalide ou expiré, ou accès du membre à l'application terminé (`invalid_token`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Portée manquante (`insufficient_scope`), membre en lecture seule (`readonly_member`), ou action que l'abonnement de l'organisation refuse.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Introuvable dans l'organisation à laquelle le jeton est lié (`not_found`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Conflit : une requête avec la même `Idempotency-Key` est encore en cours.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Cette `Idempotency-Key` a servi à une autre requête.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Limite de débit atteinte (`rate_limited`) ; réessayez après `Retry-After` secondes.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Erreur inattendue (`internal_error`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          }
        },
        "security": [
          {
            "oauth2": [
              "lexopti:read"
            ]
          }
        ],
        "x-codeSamples": [
          {
            "lang": "typescript",
            "label": "TypeScript",
            "source": "import { createLexOptiClient } from \"@lexopti/sdk\";\n\nconst lexopti = createLexOptiClient({ accessToken: () => process.env.LEXOPTI_TOKEN ?? \"\" });\n\nconst page = await lexopti.cases.list({\n\tclient_id: \"6f1b8d6e-2c4a-4f5e-9b1d-3a7c2e8f4d10\",\n});\nconsole.log(page.data.map((dossier) => dossier.label));"
          },
          {
            "lang": "curl",
            "label": "curl",
            "source": "curl -X GET \"https://app.lexopti.com/v1/cases\" \\\n  -H \"Authorization: Bearer $LEXOPTI_TOKEN\""
          },
          {
            "lang": "php",
            "label": "PHP",
            "source": "$response = (new GuzzleHttp\\Client())->request('GET', 'https://app.lexopti.com/v1/cases', [\n    'headers' => ['Authorization' => 'Bearer ' . getenv('LEXOPTI_TOKEN')],\n]);"
          }
        ]
      },
      "post": {
        "operationId": "cases.create",
        "summary": "Créer un dossier",
        "description": "Crée un dossier pour des clients existants, avec ses natures et ses parties, comme l'écran « Nouveau dossier » de LexOpti, le membre qui a autorisé votre application y étant affecté. Le dossier est payé à sa création, exactement comme l'écran le facture : un crédit par groupe de cinq personnes ou sociétés, un au moins, pour douze mois de vigilance (`POST /v1/cases/preview` donne le prix d'abord ; `quota_exceeded` quand le solde ne peut pas le payer, `subscription_inactive` sans offre en cours, rien n'est créé). Rien n'est analysé sans `launch_checks`. Envoie `case.created`. Exige un `Idempotency-Key`.",
        "tags": [
          "Cases"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clients": {
                    "type": "array",
                    "minItems": 1,
                    "maxItems": 20,
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "description": "L'identifiant LexOpti du client."
                        },
                        "external_ref": {
                          "type": "string",
                          "pattern": "^[A-Za-z0-9:._-]{1,255}$",
                          "description": "Ou la référence du client dans votre application."
                        }
                      },
                      "description": "Un client existant de l'organisation, par son identifiant ou par votre référence (l'un des deux) : créez d'abord un nouveau client avec `POST /v1/clients`."
                    },
                    "description": "Les clients du dossier, le principal en premier : des clients existants de l'organisation."
                  },
                  "types": {
                    "type": "array",
                    "minItems": 1,
                    "maxItems": 10,
                    "items": {
                      "type": "string",
                      "pattern": "^[a-z0-9_]{1,64}$"
                    },
                    "description": "Les natures du dossier, parmi celles que propose la profession de l'organisation (le portail les liste), ou `custom` avec `type_label`."
                  },
                  "type_label": {
                    "type": "string",
                    "minLength": 2,
                    "maxLength": 160,
                    "pattern": "^[^\\u0000-\\u001F\\u007F-\\u009F]*$",
                    "description": "La nature libre, avec `custom` seulement."
                  },
                  "label": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200,
                    "pattern": "^[^\\u0000-\\u001F\\u007F-\\u009F]*$",
                    "description": "Le titre du dossier ; par défaut, le nom de son client principal."
                  },
                  "parties": {
                    "type": "array",
                    "maxItems": 20,
                    "items": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "const": "person",
                              "description": "`person` ou `company` : envoyez l'objet correspondant, `person` ou `company`."
                            },
                            "role": {
                              "enum": [
                                "demandeur",
                                "defendeur",
                                "appelant",
                                "intime",
                                "intervenant",
                                "partie_adverse",
                                "vendeur",
                                "acquereur",
                                "cedant",
                                "cessionnaire",
                                "contrepartie",
                                "bailleur",
                                "locataire",
                                "preteur",
                                "emprunteur",
                                "caution",
                                "tiers_payeur",
                                "donateur",
                                "donataire",
                                "heritier_legataire",
                                "mandant",
                                "mandataire",
                                "representant_legal",
                                "intermediaire",
                                "associe",
                                "constituant",
                                "fiduciaire",
                                "beneficiaire",
                                "tiers",
                                "autre"
                              ],
                              "type": "string",
                              "description": "Le rôle de la partie dans le dossier, un code stable en français (`vendeur`, `acquereur`, `tiers_payeur`…). Chaque profession propose les siens ; un rôle qu'elle ne propose plus reste affiché sur une partie plus ancienne. De nouveaux rôles peuvent s'ajouter : affichez un rôle inconnu comme `autre`."
                            },
                            "person": {
                              "type": "object",
                              "properties": {
                                "first_name": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 255,
                                  "description": "Prénom(s), comme sur la pièce d'identité. Exemple : `Camille`."
                                },
                                "last_name": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 255,
                                  "description": "Nom de famille, comme sur la pièce d'identité. Exemple : `Durand`."
                                },
                                "usage_name": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 255,
                                  "description": "Nom d'usage, quand il diffère de `last_name` (par exemple un nom d'épouse). Exemple : `Martin`."
                                },
                                "birth_date": {
                                  "type": "string",
                                  "format": "date",
                                  "description": "Date de naissance, `AAAA-MM-JJ`. Nécessaire pour lancer une analyse (sinon `incomplete_identity`). Exemple : `1980-02-01`."
                                },
                                "birth_city": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 255,
                                  "description": "Ville de naissance. Exemple : `Lyon`."
                                },
                                "birth_country": {
                                  "type": "string",
                                  "pattern": "^[A-Za-z]{2}$",
                                  "description": "Pays de naissance : code ISO 3166-1 alpha-2 (`FR`, pas `France`), mis en majuscules par LexOpti. Exemple : `FR`."
                                },
                                "nationalities": {
                                  "type": "array",
                                  "maxItems": 10,
                                  "items": {
                                    "type": "string",
                                    "pattern": "^[A-Za-z]{2}$"
                                  },
                                  "description": "Nationalités : codes ISO 3166-1 alpha-2 (`FR`, pas `France`), mis en majuscules par LexOpti, 10 au plus. Il en faut au moins une pour lancer une analyse (sinon `incomplete_identity`) : l'analyse les compare aux nationalités des listes de sanctions et des personnes politiquement exposées (PPE). Exemple : `[\"FR\"]`."
                                }
                              },
                              "required": [
                                "first_name",
                                "last_name"
                              ],
                              "description": "L'identité de la personne, avec `type: person`."
                            },
                            "address": {
                              "type": "object",
                              "properties": {
                                "line": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 255,
                                  "description": "Numéro, voie et complément éventuel. Exemple : `12 rue de la Paix`."
                                },
                                "postal_code": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 255,
                                  "description": "Code postal. Exemple : `75002`."
                                },
                                "city": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 255,
                                  "description": "Ville. Exemple : `Paris`."
                                },
                                "country": {
                                  "type": "string",
                                  "pattern": "^[A-Za-z]{2}$",
                                  "description": "Pays : code ISO 3166-1 alpha-2 (`FR`, pas `France`), mis en majuscules par LexOpti. Exemple : `FR`."
                                }
                              },
                              "description": "L'adresse postale. Facultative."
                            },
                            "external_ref": {
                              "type": "string",
                              "pattern": "^[A-Za-z0-9:._-]{1,255}$",
                              "description": "Votre référence de la personne (un contact de votre logiciel qui n'est pas client) : la personne qu'elle nomme déjà rejoint le dossier au lieu d'une nouvelle, sinon la nouvelle partie lui est liée."
                            }
                          },
                          "required": [
                            "type",
                            "role",
                            "person"
                          ]
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "const": "company",
                              "description": "`person` ou `company` : envoyez l'objet correspondant, `person` ou `company`."
                            },
                            "role": {
                              "enum": [
                                "demandeur",
                                "defendeur",
                                "appelant",
                                "intime",
                                "intervenant",
                                "partie_adverse",
                                "vendeur",
                                "acquereur",
                                "cedant",
                                "cessionnaire",
                                "contrepartie",
                                "bailleur",
                                "locataire",
                                "preteur",
                                "emprunteur",
                                "caution",
                                "tiers_payeur",
                                "donateur",
                                "donataire",
                                "heritier_legataire",
                                "mandant",
                                "mandataire",
                                "representant_legal",
                                "intermediaire",
                                "associe",
                                "constituant",
                                "fiduciaire",
                                "beneficiaire",
                                "tiers",
                                "autre"
                              ],
                              "type": "string",
                              "description": "Le rôle de la partie dans le dossier, un code stable en français (`vendeur`, `acquereur`, `tiers_payeur`…). Chaque profession propose les siens ; un rôle qu'elle ne propose plus reste affiché sur une partie plus ancienne. De nouveaux rôles peuvent s'ajouter : affichez un rôle inconnu comme `autre`."
                            },
                            "company": {
                              "type": "object",
                              "properties": {
                                "name": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 255,
                                  "description": "Dénomination sociale. Exemple : `Atelier Durand`."
                                },
                                "siren": {
                                  "type": "string",
                                  "pattern": "^\\d{9}$",
                                  "description": "SIREN : neuf chiffres, sans espaces. Avec `registration_country`, nécessaire pour lancer une analyse sur une société française. Exemple : `552100554`."
                                },
                                "siret": {
                                  "type": "string",
                                  "pattern": "^\\d{14}$",
                                  "description": "SIRET d'un de ses établissements : 14 chiffres, sans espaces. Exemple : `55210055400013`."
                                },
                                "legal_form": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 255,
                                  "description": "Forme juridique, en général son abréviation. Exemple : `SAS`."
                                },
                                "registration_country": {
                                  "type": "string",
                                  "pattern": "^[A-Za-z]{2}$",
                                  "description": "Pays d'immatriculation : code ISO 3166-1 alpha-2 (`FR`, pas `France`), mis en majuscules par LexOpti. Exemple : `FR`."
                                },
                                "rcs": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 255,
                                  "description": "Immatriculation au RCS, comme sur le Kbis. Exemple : `Nice B 552 100 554`."
                                }
                              },
                              "required": [
                                "name"
                              ],
                              "description": "L'identité de la société, avec `type: company`."
                            },
                            "address": {
                              "type": "object",
                              "properties": {
                                "line": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 255,
                                  "description": "Numéro, voie et complément éventuel. Exemple : `12 rue de la Paix`."
                                },
                                "postal_code": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 255,
                                  "description": "Code postal. Exemple : `75002`."
                                },
                                "city": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 255,
                                  "description": "Ville. Exemple : `Paris`."
                                },
                                "country": {
                                  "type": "string",
                                  "pattern": "^[A-Za-z]{2}$",
                                  "description": "Pays : code ISO 3166-1 alpha-2 (`FR`, pas `France`), mis en majuscules par LexOpti. Exemple : `FR`."
                                }
                              },
                              "description": "L'adresse postale. Facultative."
                            },
                            "external_ref": {
                              "type": "string",
                              "pattern": "^[A-Za-z0-9:._-]{1,255}$",
                              "description": "Votre référence de la société : la société qu'elle nomme déjà rejoint le dossier au lieu d'une nouvelle, sinon la nouvelle partie lui est liée."
                            }
                          },
                          "required": [
                            "type",
                            "role",
                            "company"
                          ]
                        }
                      ],
                      "description": "Une partie du dossier qui n'en est pas cliente (la partie adverse, un vendeur, un financeur…), avec son rôle parmi ceux que propose la profession de l'organisation (le portail les liste)."
                    },
                    "description": "Les autres parties, créées avec le dossier : chacune compte comme une personne ou une société dans son prix."
                  },
                  "external_ref": {
                    "type": "string",
                    "pattern": "^[A-Za-z0-9:._-]{1,255}$",
                    "description": "Votre référence du nouveau dossier (une affaire, un mandat, une mission…), liée à sa création : une référence déjà utilisée répond 409 `external_ref_conflict` et ne crée rien."
                  },
                  "launch_checks": {
                    "type": "boolean",
                    "description": "Lance les analyses du dossier une fois créé, comme « Lancer les analyses » dans LexOpti, quand cela ne coûte rien de plus que la création ; sinon (un client existant modifié depuis sa dernière analyse compte une fois de plus) rien n'est lancé et `analyses_launched` vaut false. Les identités à analyser doivent alors être complètes (`incomplete_identity`, rien n'est créé)."
                  }
                },
                "required": [
                  "clients",
                  "types"
                ]
              },
              "examples": {
                "a_property_sale_with_a_buyer": {
                  "summary": "Une vente immobilière, avec un acquéreur",
                  "value": {
                    "clients": [
                      {
                        "id": "6f1b8d6e-2c4a-4f5e-9b1d-3a7c2e8f4d10"
                      }
                    ],
                    "types": [
                      "vente_immobiliere"
                    ],
                    "label": "Vente Durand, 12 rue des Lilas",
                    "parties": [
                      {
                        "type": "person",
                        "role": "acquereur",
                        "person": {
                          "first_name": "Léa",
                          "last_name": "Martin",
                          "birth_date": "1988-04-12",
                          "nationalities": [
                            "FR"
                          ]
                        },
                        "external_ref": "crm:contact:2001"
                      }
                    ],
                    "external_ref": "crm:matter:42"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "description": "L'identifiant LexOpti du dossier."
                    },
                    "external_ref": {
                      "anyOf": [
                        {
                          "type": "string",
                          "pattern": "^[A-Za-z0-9:._-]{1,255}$",
                          "description": "Votre propre identifiant de l'enregistrement, par exemple `crm:contact:1042` : 1 à 255 caractères parmi `A-Z a-z 0-9 : . _ -`, unique par application, organisation et type (client ou dossier). Un identifiant technique opaque, jamais une donnée personnelle (ni nom, ni date de naissance, ni e-mail…). Visible de votre seule application."
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "La référence de votre application pour le dossier, null si elle n'en a pas. La référence d'une autre application n'est jamais montrée."
                    },
                    "label": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Le titre du dossier, tel que LexOpti l'affiche."
                    },
                    "type": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Le type de dossier, tel que la politique de la profession le nomme : le premier de `types`."
                    },
                    "types": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "description": "Toutes les natures du dossier, la première étant `type` (un dossier peut en avoir plusieurs, comme l'écran de LexOpti les choisit)."
                    },
                    "type_label": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Nature libre, lorsque `type` vaut `custom`."
                    },
                    "status": {
                      "enum": [
                        "pending",
                        "running",
                        "completed",
                        "failed"
                      ],
                      "type": "string",
                      "description": "Où en est le lancement propre au dossier (`launch_checks` à la création, `POST /v1/cases/{id}/checks`, ou le bouton « Lancer les analyses » dans LexOpti) : `pending` (aucun lancé), `running` (en cours), `completed` (toutes les sources ont répondu) ou `failed` (une source n'a pas pu être interrogée). Une analyse facturée au dossier par `POST /v1/checks` avec `case_id` a son propre statut et ne change pas celui-ci : lisez `pending_alert_count` et les analyses pour les résultats des clients."
                    },
                    "client_id": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Le client principal."
                    },
                    "client_ids": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "description": "Tous les clients du dossier, le principal en premier."
                    },
                    "clients": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "description": "L'identifiant LexOpti du client."
                          },
                          "external_ref": {
                            "anyOf": [
                              {
                                "type": "string",
                                "pattern": "^[A-Za-z0-9:._-]{1,255}$",
                                "description": "Votre propre identifiant de l'enregistrement, par exemple `crm:contact:1042` : 1 à 255 caractères parmi `A-Z a-z 0-9 : . _ -`, unique par application, organisation et type (client ou dossier). Un identifiant technique opaque, jamais une donnée personnelle (ni nom, ni date de naissance, ni e-mail…). Visible de votre seule application."
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "La référence de votre application pour le client, null si elle n'en a pas."
                          },
                          "main": {
                            "type": "boolean",
                            "description": "Le client principal du dossier."
                          }
                        },
                        "required": [
                          "id",
                          "external_ref",
                          "main"
                        ]
                      },
                      "description": "Tous les clients du dossier, le principal en premier, avec vos références."
                    },
                    "parties": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "description": "L'identifiant de la partie dans ce dossier (un autre dossier donne un autre identifiant à la même personne ou société ; `entity_id` reste le même)."
                          },
                          "entity_id": {
                            "type": "string",
                            "description": "La personne ou la société : la même dans tous les dossiers dont elle est partie."
                          },
                          "external_ref": {
                            "anyOf": [
                              {
                                "type": "string",
                                "pattern": "^[A-Za-z0-9:._-]{1,255}$",
                                "description": "Votre propre identifiant de l'enregistrement, par exemple `crm:contact:1042` : 1 à 255 caractères parmi `A-Z a-z 0-9 : . _ -`, unique par application, organisation et type (client ou dossier). Un identifiant technique opaque, jamais une donnée personnelle (ni nom, ni date de naissance, ni e-mail…). Visible de votre seule application."
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "La référence de votre application pour la personne ou la société (un contact de votre logiciel qui n'est pas client), la même dans tous les dossiers dont elle est partie ; null si vous n'en avez défini aucune."
                          },
                          "role": {
                            "enum": [
                              "demandeur",
                              "defendeur",
                              "appelant",
                              "intime",
                              "intervenant",
                              "partie_adverse",
                              "vendeur",
                              "acquereur",
                              "cedant",
                              "cessionnaire",
                              "contrepartie",
                              "bailleur",
                              "locataire",
                              "preteur",
                              "emprunteur",
                              "caution",
                              "tiers_payeur",
                              "donateur",
                              "donataire",
                              "heritier_legataire",
                              "mandant",
                              "mandataire",
                              "representant_legal",
                              "intermediaire",
                              "associe",
                              "constituant",
                              "fiduciaire",
                              "beneficiaire",
                              "tiers",
                              "autre"
                            ],
                            "type": "string",
                            "description": "Le rôle de la partie dans le dossier, un code stable en français (`vendeur`, `acquereur`, `tiers_payeur`…). Chaque profession propose les siens ; un rôle qu'elle ne propose plus reste affiché sur une partie plus ancienne. De nouveaux rôles peuvent s'ajouter : affichez un rôle inconnu comme `autre`."
                          },
                          "type": {
                            "enum": [
                              "person",
                              "company"
                            ],
                            "type": "string",
                            "description": "`person` ou `company`."
                          },
                          "name": {
                            "type": "string",
                            "description": "Nom affiché."
                          },
                          "monitoring_enabled": {
                            "type": "boolean",
                            "description": "Vigilance continue : la partie est réanalysée quand les sources évoluent."
                          }
                        },
                        "required": [
                          "id",
                          "entity_id",
                          "external_ref",
                          "role",
                          "type",
                          "name",
                          "monitoring_enabled"
                        ],
                        "description": "Une partie du dossier qui n'est pas l'un de ses clients (l'autre partie, un financeur…), avec son rôle."
                      },
                      "description": "Les autres parties du dossier, avec leurs rôles."
                    },
                    "transaction_amount": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Le montant de l'opération, tel qu'un membre l'a saisi dans LexOpti : texte libre, sans unité ni format fixe. Null quand il n'est pas renseigné."
                    },
                    "monitoring_enabled": {
                      "type": "boolean",
                      "description": "Vigilance continue : le dossier est réanalysée quand les sources évoluent."
                    },
                    "vigilance_level": {
                      "anyOf": [
                        {
                          "enum": [
                            "simplified",
                            "standard",
                            "enhanced"
                          ],
                          "type": "string",
                          "description": "Niveau de vigilance que LexOpti déduit des résultats d'analyse : `simplified` (vigilance allégée), `standard` ou `enhanced` (vigilance renforcée, des vérifications plus poussées). Ce n'est pas la décision du professionnel, qui est `risk_level`. [Glossaire](https://developers.lexopti.com/fr/glossary/)."
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Niveau de vigilance que LexOpti déduit des résultats d'analyse du dossier : `simplified` (vigilance allégée), `standard` ou `enhanced` (vigilance renforcée). Null jusqu'à la première analyse du dossier. Ce n'est pas la décision du professionnel, qui est `risk_level`."
                    },
                    "risk_level": {
                      "anyOf": [
                        {
                          "enum": [
                            "simplified",
                            "standard",
                            "enhanced"
                          ],
                          "type": "string",
                          "description": "Niveau de vigilance que LexOpti déduit des résultats d'analyse : `simplified` (vigilance allégée), `standard` ou `enhanced` (vigilance renforcée, des vérifications plus poussées). Ce n'est pas la décision du professionnel, qui est `risk_level`. [Glossaire](https://developers.lexopti.com/fr/glossary/)."
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Niveau de risque du dossier, validé par le professionnel dans LexOpti et calculé sans les éléments de soupçon, qui restent confidentiels. `null` tant qu'il ne l'a pas fixé. En lecture seule : l'API ne peut pas le modifier."
                    },
                    "classification_state": {
                      "enum": [
                        "to_complete",
                        "in_progress",
                        "validated",
                        "revalidate"
                      ],
                      "type": "string",
                      "description": "L'état de la classification du dossier ; lisez-la avec `GET /v1/cases/{id}/classification`."
                    },
                    "has_pending_alert": {
                      "type": "boolean",
                      "description": "Au moins une alerte attend l'examen d'un membre."
                    },
                    "pending_alert_count": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "description": "Les alertes en attente de l'examen d'un membre, comme la page du dossier les montre : celles de chaque client du dossier et de ses parties."
                    },
                    "created_at": {
                      "type": "string",
                      "format": "date-time",
                      "description": "Date de création (ISO 8601, UTC)."
                    },
                    "updated_at": {
                      "type": "string",
                      "format": "date-time",
                      "description": "Date de dernière modification (ISO 8601, UTC)."
                    },
                    "credits_charged": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "description": "Les crédits dépensés par la création : l'ouverture du dossier, puis ses parties (calculés, jamais prélevés, dans un bac à sable)."
                    },
                    "analyses_launched": {
                      "type": "boolean",
                      "description": "Ses analyses ont été lancées (`launch_checks`) : suivez le `status` du dossier."
                    }
                  },
                  "required": [
                    "id",
                    "external_ref",
                    "label",
                    "type",
                    "types",
                    "type_label",
                    "status",
                    "client_id",
                    "client_ids",
                    "clients",
                    "parties",
                    "transaction_amount",
                    "monitoring_enabled",
                    "vigilance_level",
                    "risk_level",
                    "classification_state",
                    "has_pending_alert",
                    "pending_alert_count",
                    "created_at",
                    "updated_at",
                    "credits_charged",
                    "analyses_launched"
                  ]
                }
              }
            },
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              },
              "RateLimit": {
                "description": "Requêtes restantes et secondes avant la réinitialisation de la fenêtre.",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Policy": {
                "description": "Requêtes autorisées par fenêtre, par application.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Requête invalide : `validation_failed` liste les champs invalides.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Jeton absent, invalide ou expiré, ou accès du membre à l'application terminé (`invalid_token`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Portée manquante (`insufficient_scope`), membre en lecture seule (`readonly_member`), ou action que l'abonnement de l'organisation refuse.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Introuvable dans l'organisation à laquelle le jeton est lié (`not_found`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Conflit : une requête avec la même `Idempotency-Key` est encore en cours.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Cette `Idempotency-Key` a servi à une autre requête.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Limite de débit atteinte (`rate_limited`) ; réessayez après `Retry-After` secondes.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Erreur inattendue (`internal_error`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          }
        },
        "security": [
          {
            "oauth2": [
              "lexopti:write"
            ]
          }
        ],
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Clé unique de cette requête (un UUID) : une nouvelle tentative avec la même clé et le même corps reçoit la première réponse.",
            "schema": {
              "type": "string",
              "maxLength": 255
            }
          }
        ],
        "x-codeSamples": [
          {
            "lang": "typescript",
            "label": "TypeScript",
            "source": "import { createLexOptiClient } from \"@lexopti/sdk\";\n\nconst lexopti = createLexOptiClient({ accessToken: () => process.env.LEXOPTI_TOKEN ?? \"\" });\n\nconst dossier = await lexopti.cases.create({\n\tclients: [{ id: \"6f1b8d6e-2c4a-4f5e-9b1d-3a7c2e8f4d10\" }],\n\ttypes: [\"vente_immobiliere\"],\n\tlabel: \"Vente Durand, 12 rue des Lilas\",\n\tparties: [\n\t\t{\n\t\t\ttype: \"person\",\n\t\t\trole: \"acquereur\",\n\t\t\tperson: {\n\t\t\t\tfirst_name: \"Léa\",\n\t\t\t\tlast_name: \"Martin\",\n\t\t\t\tbirth_date: \"1988-04-12\",\n\t\t\t\tnationalities: [\"FR\"],\n\t\t\t},\n\t\t\texternal_ref: \"crm:contact:2001\",\n\t\t},\n\t],\n\texternal_ref: \"crm:deal:42\",\n});\nconsole.log(dossier.id, dossier.credits_charged, dossier.parties.length);"
          },
          {
            "lang": "curl",
            "label": "curl",
            "source": "curl -X POST \"https://app.lexopti.com/v1/cases\" \\\n  -H \"Authorization: Bearer $LEXOPTI_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Idempotency-Key: $(uuidgen)\" \\\n  -d '{\n    \"clients\": [\n      {\n        \"id\": \"6f1b8d6e-2c4a-4f5e-9b1d-3a7c2e8f4d10\"\n      }\n    ],\n    \"types\": [\n      \"vente_immobiliere\"\n    ],\n    \"label\": \"Vente Durand, 12 rue des Lilas\",\n    \"parties\": [\n      {\n        \"type\": \"person\",\n        \"role\": \"acquereur\",\n        \"person\": {\n          \"first_name\": \"Léa\",\n          \"last_name\": \"Martin\",\n          \"birth_date\": \"1988-04-12\",\n          \"nationalities\": [\n            \"FR\"\n          ]\n        },\n        \"external_ref\": \"crm:contact:2001\"\n      }\n    ],\n    \"external_ref\": \"crm:matter:42\"\n  }'"
          },
          {
            "lang": "php",
            "label": "PHP",
            "source": "$response = (new GuzzleHttp\\Client())->request('POST', 'https://app.lexopti.com/v1/cases', [\n    'headers' => ['Authorization' => 'Bearer ' . getenv('LEXOPTI_TOKEN'), 'Idempotency-Key' => uniqid('', true)],\n    'json' => [\n        'clients' => [\n            [\n                'id' => '6f1b8d6e-2c4a-4f5e-9b1d-3a7c2e8f4d10',\n            ],\n        ],\n        'types' => [\n            'vente_immobiliere',\n        ],\n        'label' => 'Vente Durand, 12 rue des Lilas',\n        'parties' => [\n            [\n                'type' => 'person',\n                'role' => 'acquereur',\n                'person' => [\n                    'first_name' => 'Léa',\n                    'last_name' => 'Martin',\n                    'birth_date' => '1988-04-12',\n                    'nationalities' => [\n                        'FR',\n                    ],\n                ],\n                'external_ref' => 'crm:contact:2001',\n            ],\n        ],\n        'external_ref' => 'crm:matter:42',\n    ],\n]);"
          }
        ]
      }
    },
    "/cases/preview": {
      "post": {
        "operationId": "cases.preview",
        "summary": "Prévisualiser le coût d’un dossier",
        "description": "Ce que coûterait maintenant la création de ce dossier, avant que rien n'existe, comme l'écran « Nouveau dossier » de LexOpti l'affiche sur son bouton : le même corps que `POST /v1/cases`, vérifié comme la création le vérifie, rien n'est écrit. Montrez-le au membre avant de créer. La création vérifie de nouveau le solde : un solde dépensé entre-temps la refuse quand même.",
        "tags": [
          "Cases"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clients": {
                    "type": "array",
                    "minItems": 1,
                    "maxItems": 20,
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "description": "L'identifiant LexOpti du client."
                        },
                        "external_ref": {
                          "type": "string",
                          "pattern": "^[A-Za-z0-9:._-]{1,255}$",
                          "description": "Ou la référence du client dans votre application."
                        }
                      },
                      "description": "Un client existant de l'organisation, par son identifiant ou par votre référence (l'un des deux) : créez d'abord un nouveau client avec `POST /v1/clients`."
                    },
                    "description": "Les clients du dossier, le principal en premier : des clients existants de l'organisation."
                  },
                  "types": {
                    "type": "array",
                    "minItems": 1,
                    "maxItems": 10,
                    "items": {
                      "type": "string",
                      "pattern": "^[a-z0-9_]{1,64}$"
                    },
                    "description": "Les natures du dossier, parmi celles que propose la profession de l'organisation (le portail les liste), ou `custom` avec `type_label`."
                  },
                  "type_label": {
                    "type": "string",
                    "minLength": 2,
                    "maxLength": 160,
                    "pattern": "^[^\\u0000-\\u001F\\u007F-\\u009F]*$",
                    "description": "La nature libre, avec `custom` seulement."
                  },
                  "label": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200,
                    "pattern": "^[^\\u0000-\\u001F\\u007F-\\u009F]*$",
                    "description": "Le titre du dossier ; par défaut, le nom de son client principal."
                  },
                  "parties": {
                    "type": "array",
                    "maxItems": 20,
                    "items": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "const": "person",
                              "description": "`person` ou `company` : envoyez l'objet correspondant, `person` ou `company`."
                            },
                            "role": {
                              "enum": [
                                "demandeur",
                                "defendeur",
                                "appelant",
                                "intime",
                                "intervenant",
                                "partie_adverse",
                                "vendeur",
                                "acquereur",
                                "cedant",
                                "cessionnaire",
                                "contrepartie",
                                "bailleur",
                                "locataire",
                                "preteur",
                                "emprunteur",
                                "caution",
                                "tiers_payeur",
                                "donateur",
                                "donataire",
                                "heritier_legataire",
                                "mandant",
                                "mandataire",
                                "representant_legal",
                                "intermediaire",
                                "associe",
                                "constituant",
                                "fiduciaire",
                                "beneficiaire",
                                "tiers",
                                "autre"
                              ],
                              "type": "string",
                              "description": "Le rôle de la partie dans le dossier, un code stable en français (`vendeur`, `acquereur`, `tiers_payeur`…). Chaque profession propose les siens ; un rôle qu'elle ne propose plus reste affiché sur une partie plus ancienne. De nouveaux rôles peuvent s'ajouter : affichez un rôle inconnu comme `autre`."
                            },
                            "person": {
                              "type": "object",
                              "properties": {
                                "first_name": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 255,
                                  "description": "Prénom(s), comme sur la pièce d'identité. Exemple : `Camille`."
                                },
                                "last_name": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 255,
                                  "description": "Nom de famille, comme sur la pièce d'identité. Exemple : `Durand`."
                                },
                                "usage_name": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 255,
                                  "description": "Nom d'usage, quand il diffère de `last_name` (par exemple un nom d'épouse). Exemple : `Martin`."
                                },
                                "birth_date": {
                                  "type": "string",
                                  "format": "date",
                                  "description": "Date de naissance, `AAAA-MM-JJ`. Nécessaire pour lancer une analyse (sinon `incomplete_identity`). Exemple : `1980-02-01`."
                                },
                                "birth_city": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 255,
                                  "description": "Ville de naissance. Exemple : `Lyon`."
                                },
                                "birth_country": {
                                  "type": "string",
                                  "pattern": "^[A-Za-z]{2}$",
                                  "description": "Pays de naissance : code ISO 3166-1 alpha-2 (`FR`, pas `France`), mis en majuscules par LexOpti. Exemple : `FR`."
                                },
                                "nationalities": {
                                  "type": "array",
                                  "maxItems": 10,
                                  "items": {
                                    "type": "string",
                                    "pattern": "^[A-Za-z]{2}$"
                                  },
                                  "description": "Nationalités : codes ISO 3166-1 alpha-2 (`FR`, pas `France`), mis en majuscules par LexOpti, 10 au plus. Il en faut au moins une pour lancer une analyse (sinon `incomplete_identity`) : l'analyse les compare aux nationalités des listes de sanctions et des personnes politiquement exposées (PPE). Exemple : `[\"FR\"]`."
                                }
                              },
                              "required": [
                                "first_name",
                                "last_name"
                              ],
                              "description": "L'identité de la personne, avec `type: person`."
                            },
                            "address": {
                              "type": "object",
                              "properties": {
                                "line": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 255,
                                  "description": "Numéro, voie et complément éventuel. Exemple : `12 rue de la Paix`."
                                },
                                "postal_code": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 255,
                                  "description": "Code postal. Exemple : `75002`."
                                },
                                "city": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 255,
                                  "description": "Ville. Exemple : `Paris`."
                                },
                                "country": {
                                  "type": "string",
                                  "pattern": "^[A-Za-z]{2}$",
                                  "description": "Pays : code ISO 3166-1 alpha-2 (`FR`, pas `France`), mis en majuscules par LexOpti. Exemple : `FR`."
                                }
                              },
                              "description": "L'adresse postale. Facultative."
                            },
                            "external_ref": {
                              "type": "string",
                              "pattern": "^[A-Za-z0-9:._-]{1,255}$",
                              "description": "Votre référence de la personne (un contact de votre logiciel qui n'est pas client) : la personne qu'elle nomme déjà rejoint le dossier au lieu d'une nouvelle, sinon la nouvelle partie lui est liée."
                            }
                          },
                          "required": [
                            "type",
                            "role",
                            "person"
                          ]
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "const": "company",
                              "description": "`person` ou `company` : envoyez l'objet correspondant, `person` ou `company`."
                            },
                            "role": {
                              "enum": [
                                "demandeur",
                                "defendeur",
                                "appelant",
                                "intime",
                                "intervenant",
                                "partie_adverse",
                                "vendeur",
                                "acquereur",
                                "cedant",
                                "cessionnaire",
                                "contrepartie",
                                "bailleur",
                                "locataire",
                                "preteur",
                                "emprunteur",
                                "caution",
                                "tiers_payeur",
                                "donateur",
                                "donataire",
                                "heritier_legataire",
                                "mandant",
                                "mandataire",
                                "representant_legal",
                                "intermediaire",
                                "associe",
                                "constituant",
                                "fiduciaire",
                                "beneficiaire",
                                "tiers",
                                "autre"
                              ],
                              "type": "string",
                              "description": "Le rôle de la partie dans le dossier, un code stable en français (`vendeur`, `acquereur`, `tiers_payeur`…). Chaque profession propose les siens ; un rôle qu'elle ne propose plus reste affiché sur une partie plus ancienne. De nouveaux rôles peuvent s'ajouter : affichez un rôle inconnu comme `autre`."
                            },
                            "company": {
                              "type": "object",
                              "properties": {
                                "name": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 255,
                                  "description": "Dénomination sociale. Exemple : `Atelier Durand`."
                                },
                                "siren": {
                                  "type": "string",
                                  "pattern": "^\\d{9}$",
                                  "description": "SIREN : neuf chiffres, sans espaces. Avec `registration_country`, nécessaire pour lancer une analyse sur une société française. Exemple : `552100554`."
                                },
                                "siret": {
                                  "type": "string",
                                  "pattern": "^\\d{14}$",
                                  "description": "SIRET d'un de ses établissements : 14 chiffres, sans espaces. Exemple : `55210055400013`."
                                },
                                "legal_form": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 255,
                                  "description": "Forme juridique, en général son abréviation. Exemple : `SAS`."
                                },
                                "registration_country": {
                                  "type": "string",
                                  "pattern": "^[A-Za-z]{2}$",
                                  "description": "Pays d'immatriculation : code ISO 3166-1 alpha-2 (`FR`, pas `France`), mis en majuscules par LexOpti. Exemple : `FR`."
                                },
                                "rcs": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 255,
                                  "description": "Immatriculation au RCS, comme sur le Kbis. Exemple : `Nice B 552 100 554`."
                                }
                              },
                              "required": [
                                "name"
                              ],
                              "description": "L'identité de la société, avec `type: company`."
                            },
                            "address": {
                              "type": "object",
                              "properties": {
                                "line": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 255,
                                  "description": "Numéro, voie et complément éventuel. Exemple : `12 rue de la Paix`."
                                },
                                "postal_code": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 255,
                                  "description": "Code postal. Exemple : `75002`."
                                },
                                "city": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 255,
                                  "description": "Ville. Exemple : `Paris`."
                                },
                                "country": {
                                  "type": "string",
                                  "pattern": "^[A-Za-z]{2}$",
                                  "description": "Pays : code ISO 3166-1 alpha-2 (`FR`, pas `France`), mis en majuscules par LexOpti. Exemple : `FR`."
                                }
                              },
                              "description": "L'adresse postale. Facultative."
                            },
                            "external_ref": {
                              "type": "string",
                              "pattern": "^[A-Za-z0-9:._-]{1,255}$",
                              "description": "Votre référence de la société : la société qu'elle nomme déjà rejoint le dossier au lieu d'une nouvelle, sinon la nouvelle partie lui est liée."
                            }
                          },
                          "required": [
                            "type",
                            "role",
                            "company"
                          ]
                        }
                      ],
                      "description": "Une partie du dossier qui n'en est pas cliente (la partie adverse, un vendeur, un financeur…), avec son rôle parmi ceux que propose la profession de l'organisation (le portail les liste)."
                    },
                    "description": "Les autres parties, créées avec le dossier : chacune compte comme une personne ou une société dans son prix."
                  },
                  "external_ref": {
                    "type": "string",
                    "pattern": "^[A-Za-z0-9:._-]{1,255}$",
                    "description": "Votre référence du nouveau dossier (une affaire, un mandat, une mission…), liée à sa création : une référence déjà utilisée répond 409 `external_ref_conflict` et ne crée rien."
                  },
                  "launch_checks": {
                    "type": "boolean",
                    "description": "Lance les analyses du dossier une fois créé, comme « Lancer les analyses » dans LexOpti, quand cela ne coûte rien de plus que la création ; sinon (un client existant modifié depuis sa dernière analyse compte une fois de plus) rien n'est lancé et `analyses_launched` vaut false. Les identités à analyser doivent alors être complètes (`incomplete_identity`, rien n'est créé)."
                  }
                },
                "required": [
                  "clients",
                  "types"
                ]
              },
              "examples": {
                "a_transfer_of_shares_with_a_company_as_transferee": {
                  "summary": "Une cession de titres, avec une société cessionnaire",
                  "value": {
                    "clients": [
                      {
                        "id": "6f1b8d6e-2c4a-4f5e-9b1d-3a7c2e8f4d10"
                      }
                    ],
                    "types": [
                      "cession_titres"
                    ],
                    "parties": [
                      {
                        "type": "company",
                        "role": "cessionnaire",
                        "company": {
                          "name": "Horizon Participations SAS",
                          "siren": "552100554",
                          "registration_country": "FR"
                        }
                      }
                    ]
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "credits": {
                      "type": "object",
                      "properties": {
                        "needed": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991,
                          "description": "Ce que dépense la création du dossier : un crédit par groupe de cinq personnes ou sociétés, un au moins."
                        },
                        "balance": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991,
                          "description": "Ce que l'organisation peut dépenser maintenant."
                        }
                      },
                      "required": [
                        "needed",
                        "balance"
                      ],
                      "description": "Un crédit = un dossier de cinq personnes ou sociétés au plus, sous vigilance pendant douze mois."
                    },
                    "sufficient_credits": {
                      "type": "boolean",
                      "description": "Le solde paie la création ; false : elle serait refusée (`quota_exceeded`)."
                    },
                    "tranches": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "description": "Les groupes de cinq personnes ou sociétés que paierait la première année du dossier."
                    },
                    "entities": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "description": "Les personnes et sociétés que comptent ces groupes : les clients avec leurs bénéficiaires effectifs (les personnes qui possèdent ou contrôlent une société) et représentants, et les parties ; celle déjà comptée par un autre dossier en cours de l'organisation ne l'est pas de nouveau."
                    },
                    "livemode": {
                      "type": "boolean",
                      "description": "False dans un bac à sable : les crédits sont calculés comme pour une vraie structure, jamais prélevés."
                    }
                  },
                  "required": [
                    "credits",
                    "sufficient_credits",
                    "tranches",
                    "entities",
                    "livemode"
                  ]
                }
              }
            },
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              },
              "RateLimit": {
                "description": "Requêtes restantes et secondes avant la réinitialisation de la fenêtre.",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Policy": {
                "description": "Requêtes autorisées par fenêtre, par application.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Requête invalide : `validation_failed` liste les champs invalides.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Jeton absent, invalide ou expiré, ou accès du membre à l'application terminé (`invalid_token`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Portée manquante (`insufficient_scope`), membre en lecture seule (`readonly_member`), ou action que l'abonnement de l'organisation refuse.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Introuvable dans l'organisation à laquelle le jeton est lié (`not_found`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Conflit : une requête avec la même `Idempotency-Key` est encore en cours.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Cette `Idempotency-Key` a servi à une autre requête.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Limite de débit atteinte (`rate_limited`) ; réessayez après `Retry-After` secondes.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Erreur inattendue (`internal_error`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          }
        },
        "security": [
          {
            "oauth2": [
              "lexopti:read"
            ]
          }
        ],
        "x-codeSamples": [
          {
            "lang": "typescript",
            "label": "TypeScript",
            "source": "import { createLexOptiClient } from \"@lexopti/sdk\";\n\nconst lexopti = createLexOptiClient({ accessToken: () => process.env.LEXOPTI_TOKEN ?? \"\" });\n\nconst preview = await lexopti.cases.preview({\n\tclients: [{ id: \"6f1b8d6e-2c4a-4f5e-9b1d-3a7c2e8f4d10\" }],\n\ttypes: [\"vente_immobiliere\"],\n\tparties: [\n\t\t{\n\t\t\ttype: \"company\",\n\t\t\trole: \"vendeur\",\n\t\t\tcompany: { name: \"SCI Horizon\", siren: \"552100554\" },\n\t\t},\n\t],\n});\nconsole.log(\n\tpreview.credits.needed,\n\tpreview.credits.balance,\n\tpreview.sufficient_credits\n);"
          },
          {
            "lang": "curl",
            "label": "curl",
            "source": "curl -X POST \"https://app.lexopti.com/v1/cases/preview\" \\\n  -H \"Authorization: Bearer $LEXOPTI_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Idempotency-Key: $(uuidgen)\" \\\n  -d '{\n    \"clients\": [\n      {\n        \"id\": \"6f1b8d6e-2c4a-4f5e-9b1d-3a7c2e8f4d10\"\n      }\n    ],\n    \"types\": [\n      \"cession_titres\"\n    ],\n    \"parties\": [\n      {\n        \"type\": \"company\",\n        \"role\": \"cessionnaire\",\n        \"company\": {\n          \"name\": \"Horizon Participations SAS\",\n          \"siren\": \"552100554\",\n          \"registration_country\": \"FR\"\n        }\n      }\n    ]\n  }'"
          },
          {
            "lang": "php",
            "label": "PHP",
            "source": "$response = (new GuzzleHttp\\Client())->request('POST', 'https://app.lexopti.com/v1/cases/preview', [\n    'headers' => ['Authorization' => 'Bearer ' . getenv('LEXOPTI_TOKEN'), 'Idempotency-Key' => uniqid('', true)],\n    'json' => [\n        'clients' => [\n            [\n                'id' => '6f1b8d6e-2c4a-4f5e-9b1d-3a7c2e8f4d10',\n            ],\n        ],\n        'types' => [\n            'cession_titres',\n        ],\n        'parties' => [\n            [\n                'type' => 'company',\n                'role' => 'cessionnaire',\n                'company' => [\n                    'name' => 'Horizon Participations SAS',\n                    'siren' => '552100554',\n                    'registration_country' => 'FR',\n                ],\n            ],\n        ],\n    ],\n]);"
          }
        ]
      }
    },
    "/cases/{id}": {
      "get": {
        "operationId": "cases.get",
        "summary": "Lire un dossier",
        "description": "Un dossier de l'organisation, avec ses clients, ses parties et leurs rôles, ses niveaux, l'état de sa classification et ses alertes en attente.",
        "tags": [
          "Cases"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "L'identifiant LexOpti, tel que la création ou une liste l'a renvoyé (retrouvez un client ou un dossier par votre propre référence avec `?external_ref=`)."
            },
            "description": "L'identifiant LexOpti, tel que la création ou une liste l'a renvoyé (retrouvez un client ou un dossier par votre propre référence avec `?external_ref=`)."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Case"
                }
              }
            },
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              },
              "RateLimit": {
                "description": "Requêtes restantes et secondes avant la réinitialisation de la fenêtre.",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Policy": {
                "description": "Requêtes autorisées par fenêtre, par application.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Requête invalide : `validation_failed` liste les champs invalides.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Jeton absent, invalide ou expiré, ou accès du membre à l'application terminé (`invalid_token`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Portée manquante (`insufficient_scope`), membre en lecture seule (`readonly_member`), ou action que l'abonnement de l'organisation refuse.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Introuvable dans l'organisation à laquelle le jeton est lié (`not_found`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Conflit : une requête avec la même `Idempotency-Key` est encore en cours.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Cette `Idempotency-Key` a servi à une autre requête.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Limite de débit atteinte (`rate_limited`) ; réessayez après `Retry-After` secondes.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Erreur inattendue (`internal_error`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          }
        },
        "security": [
          {
            "oauth2": [
              "lexopti:read"
            ]
          }
        ],
        "x-codeSamples": [
          {
            "lang": "typescript",
            "label": "TypeScript",
            "source": "import { createLexOptiClient } from \"@lexopti/sdk\";\n\nconst lexopti = createLexOptiClient({ accessToken: () => process.env.LEXOPTI_TOKEN ?? \"\" });\n\nconst dossier = await lexopti.cases.get({\n\tid: \"0c9e6a1f-8b3d-4e27-a5f6-1d2c3b4a5e60\",\n});\nconsole.log(dossier.label, dossier.risk_level, dossier.classification_state);\nfor (const client of dossier.clients) {\n\tconsole.log(client.id, client.external_ref, client.main);\n}\nfor (const party of dossier.parties) {\n\tconsole.log(party.role, party.name);\n}"
          },
          {
            "lang": "curl",
            "label": "curl",
            "source": "curl -X GET \"https://app.lexopti.com/v1/cases/:id\" \\\n  -H \"Authorization: Bearer $LEXOPTI_TOKEN\""
          },
          {
            "lang": "php",
            "label": "PHP",
            "source": "$response = (new GuzzleHttp\\Client())->request('GET', 'https://app.lexopti.com/v1/cases/:id', [\n    'headers' => ['Authorization' => 'Bearer ' . getenv('LEXOPTI_TOKEN')],\n]);"
          }
        ]
      }
    },
    "/cases/{id}/checks": {
      "post": {
        "operationId": "cases.launchChecks",
        "summary": "Lancer les analyses du dossier",
        "description": "Analyse chaque client du dossier avec les personnes qui lui sont liées, et les parties et sujets propres au dossier, comme le bouton « Lancer les analyses » de LexOpti sur la page du dossier. Sans corps. Les identités à analyser doivent être complètes (`incomplete_identity`, rien n'est lancé). Le lancement est facturé au dossier : gratuit tant que l'année payée du dossier et ses groupes de cinq personnes ou sociétés le couvrent, un crédit de plus par groupe de cinq supplémentaire, une nouvelle année une fois l'année finie (`quota_exceeded` quand le solde ne peut pas le payer, `subscription_inactive` sans offre en cours ; rien n'est lancé alors). Le lancement de chaque client est une analyse de votre application (`checks`) ; les analyses des parties appartiennent au dossier lui-même (son `status`). Asynchrone : suivez les analyses, ou attendez `check.completed` / `check.failed`. Un dossier clos répond 409 `case_closed`. Exige une `Idempotency-Key` ; une nouvelle tentative avec la même renvoie le premier lancement.",
        "tags": [
          "Cases"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "L'identifiant LexOpti, tel que la création ou une liste l'a renvoyé (retrouvez un client ou un dossier par votre propre référence avec `?external_ref=`)."
            },
            "description": "L'identifiant LexOpti, tel que la création ou une liste l'a renvoyé (retrouvez un client ou un dossier par votre propre référence avec `?external_ref=`)."
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Clé unique de cette requête (un UUID) : une nouvelle tentative avec la même clé et le même corps reçoit la première réponse.",
            "schema": {
              "type": "string",
              "maxLength": 255
            }
          }
        ],
        "responses": {
          "202": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "description": "L'identifiant LexOpti du dossier."
                    },
                    "external_ref": {
                      "anyOf": [
                        {
                          "type": "string",
                          "pattern": "^[A-Za-z0-9:._-]{1,255}$",
                          "description": "Votre propre identifiant de l'enregistrement, par exemple `crm:contact:1042` : 1 à 255 caractères parmi `A-Z a-z 0-9 : . _ -`, unique par application, organisation et type (client ou dossier). Un identifiant technique opaque, jamais une donnée personnelle (ni nom, ni date de naissance, ni e-mail…). Visible de votre seule application."
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "La référence de votre application pour le dossier, null si elle n'en a pas. La référence d'une autre application n'est jamais montrée."
                    },
                    "label": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Le titre du dossier, tel que LexOpti l'affiche."
                    },
                    "type": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Le type de dossier, tel que la politique de la profession le nomme : le premier de `types`."
                    },
                    "types": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "description": "Toutes les natures du dossier, la première étant `type` (un dossier peut en avoir plusieurs, comme l'écran de LexOpti les choisit)."
                    },
                    "type_label": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Nature libre, lorsque `type` vaut `custom`."
                    },
                    "status": {
                      "enum": [
                        "pending",
                        "running",
                        "completed",
                        "failed"
                      ],
                      "type": "string",
                      "description": "Où en est le lancement propre au dossier (`launch_checks` à la création, `POST /v1/cases/{id}/checks`, ou le bouton « Lancer les analyses » dans LexOpti) : `pending` (aucun lancé), `running` (en cours), `completed` (toutes les sources ont répondu) ou `failed` (une source n'a pas pu être interrogée). Une analyse facturée au dossier par `POST /v1/checks` avec `case_id` a son propre statut et ne change pas celui-ci : lisez `pending_alert_count` et les analyses pour les résultats des clients."
                    },
                    "client_id": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Le client principal."
                    },
                    "client_ids": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "description": "Tous les clients du dossier, le principal en premier."
                    },
                    "clients": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "description": "L'identifiant LexOpti du client."
                          },
                          "external_ref": {
                            "anyOf": [
                              {
                                "type": "string",
                                "pattern": "^[A-Za-z0-9:._-]{1,255}$",
                                "description": "Votre propre identifiant de l'enregistrement, par exemple `crm:contact:1042` : 1 à 255 caractères parmi `A-Z a-z 0-9 : . _ -`, unique par application, organisation et type (client ou dossier). Un identifiant technique opaque, jamais une donnée personnelle (ni nom, ni date de naissance, ni e-mail…). Visible de votre seule application."
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "La référence de votre application pour le client, null si elle n'en a pas."
                          },
                          "main": {
                            "type": "boolean",
                            "description": "Le client principal du dossier."
                          }
                        },
                        "required": [
                          "id",
                          "external_ref",
                          "main"
                        ]
                      },
                      "description": "Tous les clients du dossier, le principal en premier, avec vos références."
                    },
                    "parties": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "description": "L'identifiant de la partie dans ce dossier (un autre dossier donne un autre identifiant à la même personne ou société ; `entity_id` reste le même)."
                          },
                          "entity_id": {
                            "type": "string",
                            "description": "La personne ou la société : la même dans tous les dossiers dont elle est partie."
                          },
                          "external_ref": {
                            "anyOf": [
                              {
                                "type": "string",
                                "pattern": "^[A-Za-z0-9:._-]{1,255}$",
                                "description": "Votre propre identifiant de l'enregistrement, par exemple `crm:contact:1042` : 1 à 255 caractères parmi `A-Z a-z 0-9 : . _ -`, unique par application, organisation et type (client ou dossier). Un identifiant technique opaque, jamais une donnée personnelle (ni nom, ni date de naissance, ni e-mail…). Visible de votre seule application."
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "La référence de votre application pour la personne ou la société (un contact de votre logiciel qui n'est pas client), la même dans tous les dossiers dont elle est partie ; null si vous n'en avez défini aucune."
                          },
                          "role": {
                            "enum": [
                              "demandeur",
                              "defendeur",
                              "appelant",
                              "intime",
                              "intervenant",
                              "partie_adverse",
                              "vendeur",
                              "acquereur",
                              "cedant",
                              "cessionnaire",
                              "contrepartie",
                              "bailleur",
                              "locataire",
                              "preteur",
                              "emprunteur",
                              "caution",
                              "tiers_payeur",
                              "donateur",
                              "donataire",
                              "heritier_legataire",
                              "mandant",
                              "mandataire",
                              "representant_legal",
                              "intermediaire",
                              "associe",
                              "constituant",
                              "fiduciaire",
                              "beneficiaire",
                              "tiers",
                              "autre"
                            ],
                            "type": "string",
                            "description": "Le rôle de la partie dans le dossier, un code stable en français (`vendeur`, `acquereur`, `tiers_payeur`…). Chaque profession propose les siens ; un rôle qu'elle ne propose plus reste affiché sur une partie plus ancienne. De nouveaux rôles peuvent s'ajouter : affichez un rôle inconnu comme `autre`."
                          },
                          "type": {
                            "enum": [
                              "person",
                              "company"
                            ],
                            "type": "string",
                            "description": "`person` ou `company`."
                          },
                          "name": {
                            "type": "string",
                            "description": "Nom affiché."
                          },
                          "monitoring_enabled": {
                            "type": "boolean",
                            "description": "Vigilance continue : la partie est réanalysée quand les sources évoluent."
                          }
                        },
                        "required": [
                          "id",
                          "entity_id",
                          "external_ref",
                          "role",
                          "type",
                          "name",
                          "monitoring_enabled"
                        ],
                        "description": "Une partie du dossier qui n'est pas l'un de ses clients (l'autre partie, un financeur…), avec son rôle."
                      },
                      "description": "Les autres parties du dossier, avec leurs rôles."
                    },
                    "transaction_amount": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Le montant de l'opération, tel qu'un membre l'a saisi dans LexOpti : texte libre, sans unité ni format fixe. Null quand il n'est pas renseigné."
                    },
                    "monitoring_enabled": {
                      "type": "boolean",
                      "description": "Vigilance continue : le dossier est réanalysée quand les sources évoluent."
                    },
                    "vigilance_level": {
                      "anyOf": [
                        {
                          "enum": [
                            "simplified",
                            "standard",
                            "enhanced"
                          ],
                          "type": "string",
                          "description": "Niveau de vigilance que LexOpti déduit des résultats d'analyse : `simplified` (vigilance allégée), `standard` ou `enhanced` (vigilance renforcée, des vérifications plus poussées). Ce n'est pas la décision du professionnel, qui est `risk_level`. [Glossaire](https://developers.lexopti.com/fr/glossary/)."
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Niveau de vigilance que LexOpti déduit des résultats d'analyse du dossier : `simplified` (vigilance allégée), `standard` ou `enhanced` (vigilance renforcée). Null jusqu'à la première analyse du dossier. Ce n'est pas la décision du professionnel, qui est `risk_level`."
                    },
                    "risk_level": {
                      "anyOf": [
                        {
                          "enum": [
                            "simplified",
                            "standard",
                            "enhanced"
                          ],
                          "type": "string",
                          "description": "Niveau de vigilance que LexOpti déduit des résultats d'analyse : `simplified` (vigilance allégée), `standard` ou `enhanced` (vigilance renforcée, des vérifications plus poussées). Ce n'est pas la décision du professionnel, qui est `risk_level`. [Glossaire](https://developers.lexopti.com/fr/glossary/)."
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Niveau de risque du dossier, validé par le professionnel dans LexOpti et calculé sans les éléments de soupçon, qui restent confidentiels. `null` tant qu'il ne l'a pas fixé. En lecture seule : l'API ne peut pas le modifier."
                    },
                    "classification_state": {
                      "enum": [
                        "to_complete",
                        "in_progress",
                        "validated",
                        "revalidate"
                      ],
                      "type": "string",
                      "description": "L'état de la classification du dossier ; lisez-la avec `GET /v1/cases/{id}/classification`."
                    },
                    "has_pending_alert": {
                      "type": "boolean",
                      "description": "Au moins une alerte attend l'examen d'un membre."
                    },
                    "pending_alert_count": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "description": "Les alertes en attente de l'examen d'un membre, comme la page du dossier les montre : celles de chaque client du dossier et de ses parties."
                    },
                    "created_at": {
                      "type": "string",
                      "format": "date-time",
                      "description": "Date de création (ISO 8601, UTC)."
                    },
                    "updated_at": {
                      "type": "string",
                      "format": "date-time",
                      "description": "Date de dernière modification (ISO 8601, UTC)."
                    },
                    "checks": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "client_id": {
                            "type": "string",
                            "description": "Le client que cette analyse passe au crible."
                          },
                          "status": {
                            "enum": [
                              "running",
                              "completed",
                              "failed"
                            ],
                            "type": "string",
                            "description": "`running` jusqu'à la réponse de chaque source ; `failed` si l'une d'elles n'a pas pu être interrogée."
                          }
                        },
                        "required": [
                          "id",
                          "client_id",
                          "status"
                        ],
                        "description": "L'analyse d'un client, lancée par cet appel : lisez-la avec `GET /v1/checks/{id}` pour le statut de chaque source."
                      },
                      "description": "Les analyses que ce lancement a créées, une par client du dossier qu'il a analysé (un client déjà analysé, sans rien de nouveau à analyser, n'en reçoit aucune). Les analyses des parties appartiennent au dossier lui-même : suivez son `status`."
                    }
                  },
                  "required": [
                    "id",
                    "external_ref",
                    "label",
                    "type",
                    "types",
                    "type_label",
                    "status",
                    "client_id",
                    "client_ids",
                    "clients",
                    "parties",
                    "transaction_amount",
                    "monitoring_enabled",
                    "vigilance_level",
                    "risk_level",
                    "classification_state",
                    "has_pending_alert",
                    "pending_alert_count",
                    "created_at",
                    "updated_at",
                    "checks"
                  ]
                }
              }
            },
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              },
              "RateLimit": {
                "description": "Requêtes restantes et secondes avant la réinitialisation de la fenêtre.",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Policy": {
                "description": "Requêtes autorisées par fenêtre, par application.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Requête invalide : `validation_failed` liste les champs invalides.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Jeton absent, invalide ou expiré, ou accès du membre à l'application terminé (`invalid_token`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Portée manquante (`insufficient_scope`), membre en lecture seule (`readonly_member`), ou action que l'abonnement de l'organisation refuse.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Introuvable dans l'organisation à laquelle le jeton est lié (`not_found`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Conflit : une requête avec la même `Idempotency-Key` est encore en cours.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Cette `Idempotency-Key` a servi à une autre requête.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Limite de débit atteinte (`rate_limited`) ; réessayez après `Retry-After` secondes.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Erreur inattendue (`internal_error`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          }
        },
        "security": [
          {
            "oauth2": [
              "lexopti:write"
            ]
          }
        ],
        "x-codeSamples": [
          {
            "lang": "typescript",
            "label": "TypeScript",
            "source": "import { createLexOptiClient } from \"@lexopti/sdk\";\n\nconst lexopti = createLexOptiClient({ accessToken: () => process.env.LEXOPTI_TOKEN ?? \"\" });\n\nconst launch = await lexopti.cases.launchChecks({\n\tid: \"0c9e6a1f-8b3d-4e27-a5f6-1d2c3b4a5e60\",\n});\nconsole.log(launch.status, launch.checks.length);\nfor (const check of launch.checks) {\n\tconsole.log(check.id, check.client_id, check.status);\n}"
          },
          {
            "lang": "curl",
            "label": "curl",
            "source": "curl -X POST \"https://app.lexopti.com/v1/cases/:id/checks\" \\\n  -H \"Authorization: Bearer $LEXOPTI_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Idempotency-Key: $(uuidgen)\" \\\n  -d '{}'"
          },
          {
            "lang": "php",
            "label": "PHP",
            "source": "$response = (new GuzzleHttp\\Client())->request('POST', 'https://app.lexopti.com/v1/cases/:id/checks', [\n    'headers' => ['Authorization' => 'Bearer ' . getenv('LEXOPTI_TOKEN'), 'Idempotency-Key' => uniqid('', true)],\n    'json' => [],\n]);"
          }
        ]
      }
    },
    "/cases/{id}/classification": {
      "get": {
        "operationId": "cases.getClassification",
        "summary": "Lire la classification du dossier",
        "description": "L'évaluation de risque du dossier telle qu'elle est enregistrée : le questionnaire qu'un membre remplit sur le risque du dossier, appelé « classification TRACFIN » dans LexOpti. Son état, son score et son niveau de vigilance, sa dernière validation, ses réponses (tous les axes, avec les réponses `axe2` de ses clients) et les questions encore sans réponse. En lecture seule : seul un membre y répond et la valide, dans LexOpti ou ses écrans embarqués. La lecture ne modifie rien. Un dossier jamais évaluée répond `to_complete`, sans réponses. [Glossaire](https://developers.lexopti.com/fr/glossary/).",
        "tags": [
          "Cases"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "L'identifiant LexOpti, tel que la création ou une liste l'a renvoyé (retrouvez un client ou un dossier par votre propre référence avec `?external_ref=`)."
            },
            "description": "L'identifiant LexOpti, tel que la création ou une liste l'a renvoyé (retrouvez un client ou un dossier par votre propre référence avec `?external_ref=`)."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Classification"
                }
              }
            },
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              },
              "RateLimit": {
                "description": "Requêtes restantes et secondes avant la réinitialisation de la fenêtre.",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Policy": {
                "description": "Requêtes autorisées par fenêtre, par application.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Requête invalide : `validation_failed` liste les champs invalides.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Jeton absent, invalide ou expiré, ou accès du membre à l'application terminé (`invalid_token`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Portée manquante (`insufficient_scope`), membre en lecture seule (`readonly_member`), ou action que l'abonnement de l'organisation refuse.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Introuvable dans l'organisation à laquelle le jeton est lié (`not_found`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Conflit : une requête avec la même `Idempotency-Key` est encore en cours.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Cette `Idempotency-Key` a servi à une autre requête.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Limite de débit atteinte (`rate_limited`) ; réessayez après `Retry-After` secondes.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Erreur inattendue (`internal_error`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          }
        },
        "security": [
          {
            "oauth2": [
              "lexopti:read"
            ]
          }
        ],
        "x-codeSamples": [
          {
            "lang": "typescript",
            "label": "TypeScript",
            "source": "import { createLexOptiClient } from \"@lexopti/sdk\";\n\nconst lexopti = createLexOptiClient({ accessToken: () => process.env.LEXOPTI_TOKEN ?? \"\" });\n\nconst classification = await lexopti.cases.getClassification({\n\tid: \"0c9e6a1f-8b3d-4e27-a5f6-1d2c3b4a5e60\",\n});\nif (classification.state === \"validated\") {\n\tconsole.log(classification.level, classification.validated_at);\n} else {\n\tconsole.log(classification.state, classification.missing_answers.count);\n}"
          },
          {
            "lang": "curl",
            "label": "curl",
            "source": "curl -X GET \"https://app.lexopti.com/v1/cases/:id/classification\" \\\n  -H \"Authorization: Bearer $LEXOPTI_TOKEN\""
          },
          {
            "lang": "php",
            "label": "PHP",
            "source": "$response = (new GuzzleHttp\\Client())->request('GET', 'https://app.lexopti.com/v1/cases/:id/classification', [\n    'headers' => ['Authorization' => 'Bearer ' . getenv('LEXOPTI_TOKEN')],\n]);"
          }
        ]
      }
    },
    "/cases/{id}/report": {
      "get": {
        "operationId": "cases.getReport",
        "summary": "Obtenir le rapport du dossier",
        "description": "Le rapport du dossier en PDF, par une URL signée valable 5 minutes : le rapport de LexOpti lui-même, produit depuis l'état actuel du dossier, dans sa version destinée aux partenaires, qui ne contient jamais l'axe soupçon (axe 5 et ses critères de fraude) et calcule ses scores sans lui. Sa `version` (aussi l'en-tête `ETag`) désigne son contenu : la même version est le même fichier. Le premier appel pour une nouvelle version la produit (quelques secondes) ; les suivants la réutilisent. Jamais archivé comme une version du rapport du membre. Langue selon `Accept-Language`.",
        "tags": [
          "Cases"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "L'identifiant LexOpti, tel que la création ou une liste l'a renvoyé (retrouvez un client ou un dossier par votre propre référence avec `?external_ref=`)."
            },
            "description": "L'identifiant LexOpti, tel que la création ou une liste l'a renvoyé (retrouvez un client ou un dossier par votre propre référence avec `?external_ref=`)."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "case_id": {
                      "type": "string"
                    },
                    "version": {
                      "type": "string",
                      "pattern": "^[0-9a-f]{64}$",
                      "description": "Désigne ce que montre le rapport : la même version est le même contenu, dans toutes les langues. Elle change quand les personnes, les analyses ou la classification du dossier changent (l'axe soupçon mis à part). Aussi l'en-tête `ETag`."
                    },
                    "sha256": {
                      "type": "string",
                      "pattern": "^[0-9a-f]{64}$",
                      "description": "SHA-256 du fichier PDF, en hexadécimal : vérifiez le fichier téléchargé avec lui."
                    },
                    "language": {
                      "enum": [
                        "fr",
                        "en"
                      ],
                      "type": "string",
                      "description": "La langue du rapport, selon `Accept-Language`."
                    },
                    "generated_at": {
                      "type": "string",
                      "format": "date-time",
                      "description": "Quand ce fichier a été produit ; la même version est réutilisée."
                    },
                    "excluded_axes": {
                      "type": "array",
                      "items": {
                        "const": "axe5"
                      },
                      "description": "Jamais dans ce rapport : l'axe soupçon (`axe5`, ses critères de fraude), que la loi interdit de divulguer (art. L. 561-18 du Code monétaire et financier). Ses scores sont calculés sans lui."
                    },
                    "content_type": {
                      "const": "application/pdf"
                    },
                    "download_url": {
                      "type": "string",
                      "format": "uri",
                      "description": "Une URL signée pour télécharger le fichier, valable 5 minutes (`expires_at`), sans votre jeton d'accès. Ne la conservez pas : relisez la ressource pour en obtenir une nouvelle."
                    },
                    "expires_at": {
                      "type": "string",
                      "format": "date-time"
                    }
                  },
                  "required": [
                    "case_id",
                    "version",
                    "sha256",
                    "language",
                    "generated_at",
                    "excluded_axes",
                    "content_type",
                    "download_url",
                    "expires_at"
                  ]
                }
              }
            },
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              },
              "RateLimit": {
                "description": "Requêtes restantes et secondes avant la réinitialisation de la fenêtre.",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Policy": {
                "description": "Requêtes autorisées par fenêtre, par application.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Requête invalide : `validation_failed` liste les champs invalides.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Jeton absent, invalide ou expiré, ou accès du membre à l'application terminé (`invalid_token`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Portée manquante (`insufficient_scope`), membre en lecture seule (`readonly_member`), ou action que l'abonnement de l'organisation refuse.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Introuvable dans l'organisation à laquelle le jeton est lié (`not_found`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Conflit : une requête avec la même `Idempotency-Key` est encore en cours.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Cette `Idempotency-Key` a servi à une autre requête.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Limite de débit atteinte (`rate_limited`) ; réessayez après `Retry-After` secondes.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Erreur inattendue (`internal_error`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          }
        },
        "security": [
          {
            "oauth2": [
              "lexopti:read"
            ]
          }
        ],
        "x-codeSamples": [
          {
            "lang": "typescript",
            "label": "TypeScript",
            "source": "import { createLexOptiClient } from \"@lexopti/sdk\";\n\nconst lexopti = createLexOptiClient({ accessToken: () => process.env.LEXOPTI_TOKEN ?? \"\" });\n\nconst report = await lexopti.cases.getReport({\n\tid: \"0c9e6a1f-8b3d-4e27-a5f6-1d2c3b4a5e60\",\n});\n// The same version is the same file: download it only when it changed.\nconsole.log(report.version, report.sha256, report.excluded_axes);\n// Then fetch report.download_url (valid 5 minutes, no token needed) and\n// check its SHA-256 against report.sha256."
          },
          {
            "lang": "curl",
            "label": "curl",
            "source": "curl -X GET \"https://app.lexopti.com/v1/cases/:id/report\" \\\n  -H \"Authorization: Bearer $LEXOPTI_TOKEN\""
          },
          {
            "lang": "php",
            "label": "PHP",
            "source": "$response = (new GuzzleHttp\\Client())->request('GET', 'https://app.lexopti.com/v1/cases/:id/report', [\n    'headers' => ['Authorization' => 'Bearer ' . getenv('LEXOPTI_TOKEN')],\n]);"
          }
        ]
      }
    },
    "/cases/{id}/documents": {
      "get": {
        "operationId": "cases.listDocuments",
        "summary": "Lister les documents du dossier",
        "description": "Les documents du dossier, du plus récent au plus ancien, chacun avec une URL signée valable 5 minutes. Les versions du rapport du membre n'en font pas partie : lisez le rapport avec `GET /v1/cases/{id}/report`.",
        "tags": [
          "Cases"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "L'identifiant LexOpti, tel que la création ou une liste l'a renvoyé (retrouvez un client ou un dossier par votre propre référence avec `?external_ref=`)."
            },
            "description": "L'identifiant LexOpti, tel que la création ou une liste l'a renvoyé (retrouvez un client ou un dossier par votre propre référence avec `?external_ref=`)."
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 25,
              "description": "Taille de page, de 1 à 100."
            },
            "allowEmptyValue": true,
            "allowReserved": true,
            "description": "Taille de page, de 1 à 100."
          },
          {
            "name": "cursor",
            "in": "query",
            "schema": {
              "type": "string",
              "description": "`next_cursor` de la page précédente ; à omettre pour la première page."
            },
            "allowEmptyValue": true,
            "allowReserved": true,
            "description": "`next_cursor` de la page précédente ; à omettre pour la première page."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "case_id": {
                            "type": "string"
                          },
                          "category": {
                            "enum": [
                              "imported",
                              "collected"
                            ],
                            "type": "string",
                            "description": "`imported` : ajouté par un membre ; `collected` : recueilli par LexOpti auprès d'une source (`collected_from`)."
                          },
                          "collected_from": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "La source d'un document recueilli, par exemple `bodacc` (le Bulletin officiel des annonces civiles et commerciales)."
                          },
                          "file_name": {
                            "type": "string"
                          },
                          "content_type": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "size_bytes": {
                            "anyOf": [
                              {
                                "type": "integer",
                                "minimum": -9007199254740991,
                                "maximum": 9007199254740991
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "entity_id": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "La personne ou la société que concerne le document, le cas échéant."
                          },
                          "created_at": {
                            "type": "string",
                            "format": "date-time"
                          },
                          "download_url": {
                            "type": "string",
                            "format": "uri",
                            "description": "Une URL signée pour télécharger le fichier, valable 5 minutes (`expires_at`), sans votre jeton d'accès. Ne la conservez pas : relisez la ressource pour en obtenir une nouvelle."
                          },
                          "expires_at": {
                            "type": "string",
                            "format": "date-time"
                          }
                        },
                        "required": [
                          "id",
                          "case_id",
                          "category",
                          "collected_from",
                          "file_name",
                          "content_type",
                          "size_bytes",
                          "entity_id",
                          "created_at",
                          "download_url",
                          "expires_at"
                        ]
                      }
                    },
                    "has_more": {
                      "type": "boolean"
                    },
                    "next_cursor": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "À passer en `cursor` pour lire la page suivante ; null sur la dernière."
                    }
                  },
                  "required": [
                    "data",
                    "has_more",
                    "next_cursor"
                  ]
                }
              }
            },
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              },
              "RateLimit": {
                "description": "Requêtes restantes et secondes avant la réinitialisation de la fenêtre.",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Policy": {
                "description": "Requêtes autorisées par fenêtre, par application.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Requête invalide : `validation_failed` liste les champs invalides.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Jeton absent, invalide ou expiré, ou accès du membre à l'application terminé (`invalid_token`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Portée manquante (`insufficient_scope`), membre en lecture seule (`readonly_member`), ou action que l'abonnement de l'organisation refuse.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Introuvable dans l'organisation à laquelle le jeton est lié (`not_found`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Conflit : une requête avec la même `Idempotency-Key` est encore en cours.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Cette `Idempotency-Key` a servi à une autre requête.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Limite de débit atteinte (`rate_limited`) ; réessayez après `Retry-After` secondes.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Erreur inattendue (`internal_error`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          }
        },
        "security": [
          {
            "oauth2": [
              "lexopti:read"
            ]
          }
        ],
        "x-codeSamples": [
          {
            "lang": "typescript",
            "label": "TypeScript",
            "source": "import { createLexOptiClient } from \"@lexopti/sdk\";\n\nconst lexopti = createLexOptiClient({ accessToken: () => process.env.LEXOPTI_TOKEN ?? \"\" });\n\nconst page = await lexopti.cases.listDocuments({\n\tid: \"0c9e6a1f-8b3d-4e27-a5f6-1d2c3b4a5e60\",\n});\nfor (const document of page.data) {\n\tconsole.log(document.file_name, document.category, document.expires_at);\n}"
          },
          {
            "lang": "curl",
            "label": "curl",
            "source": "curl -X GET \"https://app.lexopti.com/v1/cases/:id/documents\" \\\n  -H \"Authorization: Bearer $LEXOPTI_TOKEN\""
          },
          {
            "lang": "php",
            "label": "PHP",
            "source": "$response = (new GuzzleHttp\\Client())->request('GET', 'https://app.lexopti.com/v1/cases/:id/documents', [\n    'headers' => ['Authorization' => 'Bearer ' . getenv('LEXOPTI_TOKEN')],\n]);"
          }
        ]
      }
    },
    "/cases/{id}/external-ref": {
      "put": {
        "operationId": "cases.setExternalRef",
        "summary": "Définir la référence du dossier",
        "description": "Lie le dossier à votre propre identifiant, en remplaçant votre référence précédente ; la même référence une nouvelle fois ne change rien. Une référence qui désigne déjà un autre dossier répond 409 `external_ref_conflict`. Visible de votre seule application.",
        "tags": [
          "Cases"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "L'identifiant LexOpti, tel que la création ou une liste l'a renvoyé (retrouvez un client ou un dossier par votre propre référence avec `?external_ref=`)."
            },
            "description": "L'identifiant LexOpti, tel que la création ou une liste l'a renvoyé (retrouvez un client ou un dossier par votre propre référence avec `?external_ref=`)."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "external_ref": {
                    "type": "string",
                    "pattern": "^[A-Za-z0-9:._-]{1,255}$",
                    "description": "Votre propre identifiant de l'enregistrement, par exemple `crm:contact:1042` : 1 à 255 caractères parmi `A-Z a-z 0-9 : . _ -`, unique par application, organisation et type (client ou dossier). Un identifiant technique opaque, jamais une donnée personnelle (ni nom, ni date de naissance, ni e-mail…). Visible de votre seule application."
                  }
                },
                "required": [
                  "external_ref"
                ]
              },
              "examples": {
                "your_matter_s_id": {
                  "summary": "L'identifiant de votre affaire",
                  "value": {
                    "external_ref": "crm:matter:42"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Case"
                }
              }
            },
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              },
              "RateLimit": {
                "description": "Requêtes restantes et secondes avant la réinitialisation de la fenêtre.",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Policy": {
                "description": "Requêtes autorisées par fenêtre, par application.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Requête invalide : `validation_failed` liste les champs invalides.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Jeton absent, invalide ou expiré, ou accès du membre à l'application terminé (`invalid_token`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Portée manquante (`insufficient_scope`), membre en lecture seule (`readonly_member`), ou action que l'abonnement de l'organisation refuse.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Introuvable dans l'organisation à laquelle le jeton est lié (`not_found`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "L'`external_ref` désigne déjà un autre dossier de votre application (`external_ref_conflict`) : retrouvez-la avec `GET /v1/cases?external_ref=`.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Cette `Idempotency-Key` a servi à une autre requête.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Limite de débit atteinte (`rate_limited`) ; réessayez après `Retry-After` secondes.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Erreur inattendue (`internal_error`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          }
        },
        "security": [
          {
            "oauth2": [
              "lexopti:write"
            ]
          }
        ],
        "x-codeSamples": [
          {
            "lang": "typescript",
            "label": "TypeScript",
            "source": "import { createLexOptiClient } from \"@lexopti/sdk\";\n\nconst lexopti = createLexOptiClient({ accessToken: () => process.env.LEXOPTI_TOKEN ?? \"\" });\n\nconst dossier = await lexopti.cases.setExternalRef({\n\tid: \"0c9e6a1f-8b3d-4e27-a5f6-1d2c3b4a5e60\",\n\texternal_ref: \"crm:mandate:318\",\n});\nconst page = await lexopti.cases.list({ external_ref: \"crm:mandate:318\" });\nconsole.log(dossier.external_ref, page.data[0]?.id);"
          },
          {
            "lang": "curl",
            "label": "curl",
            "source": "curl -X PUT \"https://app.lexopti.com/v1/cases/:id/external-ref\" \\\n  -H \"Authorization: Bearer $LEXOPTI_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Idempotency-Key: $(uuidgen)\" \\\n  -d '{\n    \"external_ref\": \"crm:matter:42\"\n  }'"
          },
          {
            "lang": "php",
            "label": "PHP",
            "source": "$response = (new GuzzleHttp\\Client())->request('PUT', 'https://app.lexopti.com/v1/cases/:id/external-ref', [\n    'headers' => ['Authorization' => 'Bearer ' . getenv('LEXOPTI_TOKEN'), 'Idempotency-Key' => uniqid('', true)],\n    'json' => [\n        'external_ref' => 'crm:matter:42',\n    ],\n]);"
          }
        ]
      },
      "delete": {
        "operationId": "cases.deleteExternalRef",
        "summary": "Retirer la référence du dossier",
        "description": "Délie le dossier de votre référence, qui peut alors désigner un autre dossier. Idempotent : un dossier sans référence répond de même. Les références des autres applications restent.",
        "tags": [
          "Cases"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "L'identifiant LexOpti, tel que la création ou une liste l'a renvoyé (retrouvez un client ou un dossier par votre propre référence avec `?external_ref=`)."
            },
            "description": "L'identifiant LexOpti, tel que la création ou une liste l'a renvoyé (retrouvez un client ou un dossier par votre propre référence avec `?external_ref=`)."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Case"
                }
              }
            },
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              },
              "RateLimit": {
                "description": "Requêtes restantes et secondes avant la réinitialisation de la fenêtre.",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Policy": {
                "description": "Requêtes autorisées par fenêtre, par application.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Requête invalide : `validation_failed` liste les champs invalides.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Jeton absent, invalide ou expiré, ou accès du membre à l'application terminé (`invalid_token`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Portée manquante (`insufficient_scope`), membre en lecture seule (`readonly_member`), ou action que l'abonnement de l'organisation refuse.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Introuvable dans l'organisation à laquelle le jeton est lié (`not_found`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Conflit : une requête avec la même `Idempotency-Key` est encore en cours.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Cette `Idempotency-Key` a servi à une autre requête.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Limite de débit atteinte (`rate_limited`) ; réessayez après `Retry-After` secondes.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Erreur inattendue (`internal_error`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          }
        },
        "security": [
          {
            "oauth2": [
              "lexopti:write"
            ]
          }
        ],
        "x-codeSamples": [
          {
            "lang": "typescript",
            "label": "TypeScript",
            "source": "import { createLexOptiClient } from \"@lexopti/sdk\";\n\nconst lexopti = createLexOptiClient({ accessToken: () => process.env.LEXOPTI_TOKEN ?? \"\" });\n\nconst dossier = await lexopti.cases.deleteExternalRef({\n\tid: \"0c9e6a1f-8b3d-4e27-a5f6-1d2c3b4a5e60\",\n});\nconsole.log(dossier.external_ref);"
          },
          {
            "lang": "curl",
            "label": "curl",
            "source": "curl -X DELETE \"https://app.lexopti.com/v1/cases/:id/external-ref\" \\\n  -H \"Authorization: Bearer $LEXOPTI_TOKEN\""
          },
          {
            "lang": "php",
            "label": "PHP",
            "source": "$response = (new GuzzleHttp\\Client())->request('DELETE', 'https://app.lexopti.com/v1/cases/:id/external-ref', [\n    'headers' => ['Authorization' => 'Bearer ' . getenv('LEXOPTI_TOKEN')],\n]);"
          }
        ]
      }
    },
    "/cases/{id}/parties/{party_id}/external-ref": {
      "put": {
        "operationId": "cases.setPartyExternalRef",
        "summary": "Définir la référence d'une partie",
        "description": "Relie une partie du dossier (l'autre partie, un prêteur, un vendeur… qui n'est pas client) à votre propre identifiant de cette personne ou société, en remplaçant le précédent ; la même référence ne change rien. La référence désigne la personne ou la société : elle la suit dans tous les dossiers dont elle est partie. Une référence qui désigne déjà une autre partie répond 409 `external_ref_conflict`. Visible de votre seule application.",
        "tags": [
          "Cases"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "L'identifiant LexOpti, tel que la création ou une liste l'a renvoyé (retrouvez un client ou un dossier par votre propre référence avec `?external_ref=`)."
            },
            "description": "L'identifiant LexOpti, tel que la création ou une liste l'a renvoyé (retrouvez un client ou un dossier par votre propre référence avec `?external_ref=`)."
          },
          {
            "name": "party_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "L'`id` de la partie dans le dossier (`parties[].id`)."
            },
            "description": "L'`id` de la partie dans le dossier (`parties[].id`)."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "external_ref": {
                    "type": "string",
                    "pattern": "^[A-Za-z0-9:._-]{1,255}$",
                    "description": "Votre propre identifiant de l'enregistrement, par exemple `crm:contact:1042` : 1 à 255 caractères parmi `A-Z a-z 0-9 : . _ -`, unique par application, organisation et type (client ou dossier). Un identifiant technique opaque, jamais une donnée personnelle (ni nom, ni date de naissance, ni e-mail…). Visible de votre seule application."
                  }
                },
                "required": [
                  "external_ref"
                ]
              },
              "examples": {
                "your_contact_s_id": {
                  "summary": "L'identifiant de votre contact",
                  "value": {
                    "external_ref": "crm:contact:2001"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Case"
                }
              }
            },
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              },
              "RateLimit": {
                "description": "Requêtes restantes et secondes avant la réinitialisation de la fenêtre.",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Policy": {
                "description": "Requêtes autorisées par fenêtre, par application.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Requête invalide : `validation_failed` liste les champs invalides.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Jeton absent, invalide ou expiré, ou accès du membre à l'application terminé (`invalid_token`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Portée manquante (`insufficient_scope`), membre en lecture seule (`readonly_member`), ou action que l'abonnement de l'organisation refuse.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Introuvable dans l'organisation à laquelle le jeton est lié (`not_found`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Conflit : une requête avec la même `Idempotency-Key` est encore en cours.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Cette `Idempotency-Key` a servi à une autre requête.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Limite de débit atteinte (`rate_limited`) ; réessayez après `Retry-After` secondes.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Erreur inattendue (`internal_error`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          }
        },
        "security": [
          {
            "oauth2": [
              "lexopti:write"
            ]
          }
        ],
        "x-codeSamples": [
          {
            "lang": "typescript",
            "label": "TypeScript",
            "source": "import { createLexOptiClient } from \"@lexopti/sdk\";\n\nconst lexopti = createLexOptiClient({ accessToken: () => process.env.LEXOPTI_TOKEN ?? \"\" });\n\nconst dossier = await lexopti.cases.setPartyExternalRef({\n\tid: \"0c9e6a1f-8b3d-4e27-a5f6-1d2c3b4a5e60\",\n\tparty_id: \"b7c1e2d3-4f5a-4b6c-8d7e-9f0a1b2c3d4e\",\n\texternal_ref: \"crm:contact:77\",\n});\n// Every case that contact is a party of.\nconst cases = await lexopti.cases.list({\n\tparty_external_ref: \"crm:contact:77\",\n});\nconsole.log(dossier.parties[0]?.external_ref, cases.data.length);"
          },
          {
            "lang": "curl",
            "label": "curl",
            "source": "curl -X PUT \"https://app.lexopti.com/v1/cases/:id/parties/:party_id/external-ref\" \\\n  -H \"Authorization: Bearer $LEXOPTI_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Idempotency-Key: $(uuidgen)\" \\\n  -d '{\n    \"external_ref\": \"crm:contact:2001\"\n  }'"
          },
          {
            "lang": "php",
            "label": "PHP",
            "source": "$response = (new GuzzleHttp\\Client())->request('PUT', 'https://app.lexopti.com/v1/cases/:id/parties/:party_id/external-ref', [\n    'headers' => ['Authorization' => 'Bearer ' . getenv('LEXOPTI_TOKEN'), 'Idempotency-Key' => uniqid('', true)],\n    'json' => [\n        'external_ref' => 'crm:contact:2001',\n    ],\n]);"
          }
        ]
      },
      "delete": {
        "operationId": "cases.deletePartyExternalRef",
        "summary": "Retirer la référence d'une partie",
        "description": "Délie la personne ou la société de la partie de votre référence, dans tous les dossiers dont elle est partie. Idempotent : une partie sans référence répond de même.",
        "tags": [
          "Cases"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "L'identifiant LexOpti, tel que la création ou une liste l'a renvoyé (retrouvez un client ou un dossier par votre propre référence avec `?external_ref=`)."
            },
            "description": "L'identifiant LexOpti, tel que la création ou une liste l'a renvoyé (retrouvez un client ou un dossier par votre propre référence avec `?external_ref=`)."
          },
          {
            "name": "party_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "L'`id` de la partie dans le dossier (`parties[].id`)."
            },
            "description": "L'`id` de la partie dans le dossier (`parties[].id`)."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Case"
                }
              }
            },
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              },
              "RateLimit": {
                "description": "Requêtes restantes et secondes avant la réinitialisation de la fenêtre.",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Policy": {
                "description": "Requêtes autorisées par fenêtre, par application.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Requête invalide : `validation_failed` liste les champs invalides.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Jeton absent, invalide ou expiré, ou accès du membre à l'application terminé (`invalid_token`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Portée manquante (`insufficient_scope`), membre en lecture seule (`readonly_member`), ou action que l'abonnement de l'organisation refuse.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Introuvable dans l'organisation à laquelle le jeton est lié (`not_found`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Conflit : une requête avec la même `Idempotency-Key` est encore en cours.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Cette `Idempotency-Key` a servi à une autre requête.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Limite de débit atteinte (`rate_limited`) ; réessayez après `Retry-After` secondes.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Erreur inattendue (`internal_error`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          }
        },
        "security": [
          {
            "oauth2": [
              "lexopti:write"
            ]
          }
        ],
        "x-codeSamples": [
          {
            "lang": "typescript",
            "label": "TypeScript",
            "source": "import { createLexOptiClient } from \"@lexopti/sdk\";\n\nconst lexopti = createLexOptiClient({ accessToken: () => process.env.LEXOPTI_TOKEN ?? \"\" });\n\nconst dossier = await lexopti.cases.deletePartyExternalRef({\n\tid: \"0c9e6a1f-8b3d-4e27-a5f6-1d2c3b4a5e60\",\n\tparty_id: \"b7c1e2d3-4f5a-4b6c-8d7e-9f0a1b2c3d4e\",\n});\nconsole.log(dossier.parties[0]?.external_ref);"
          },
          {
            "lang": "curl",
            "label": "curl",
            "source": "curl -X DELETE \"https://app.lexopti.com/v1/cases/:id/parties/:party_id/external-ref\" \\\n  -H \"Authorization: Bearer $LEXOPTI_TOKEN\""
          },
          {
            "lang": "php",
            "label": "PHP",
            "source": "$response = (new GuzzleHttp\\Client())->request('DELETE', 'https://app.lexopti.com/v1/cases/:id/parties/:party_id/external-ref', [\n    'headers' => ['Authorization' => 'Bearer ' . getenv('LEXOPTI_TOKEN')],\n]);"
          }
        ]
      }
    },
    "/checks": {
      "get": {
        "operationId": "checks.list",
        "summary": "Lister les analyses",
        "description": "Les analyses de l'organisation, de la plus récente à la plus ancienne.",
        "tags": [
          "Checks"
        ],
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 25,
              "description": "Taille de page, de 1 à 100."
            },
            "allowEmptyValue": true,
            "allowReserved": true,
            "description": "Taille de page, de 1 à 100."
          },
          {
            "name": "cursor",
            "in": "query",
            "schema": {
              "type": "string",
              "description": "`next_cursor` de la page précédente ; à omettre pour la première page."
            },
            "allowEmptyValue": true,
            "allowReserved": true,
            "description": "`next_cursor` de la page précédente ; à omettre pour la première page."
          },
          {
            "name": "client_id",
            "in": "query",
            "schema": {
              "type": "string",
              "description": "Seulement les analyses de ce client."
            },
            "allowEmptyValue": true,
            "allowReserved": true,
            "description": "Seulement les analyses de ce client."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Check"
                      }
                    },
                    "has_more": {
                      "type": "boolean"
                    },
                    "next_cursor": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "À passer en `cursor` pour lire la page suivante ; null sur la dernière."
                    }
                  },
                  "required": [
                    "data",
                    "has_more",
                    "next_cursor"
                  ]
                }
              }
            },
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              },
              "RateLimit": {
                "description": "Requêtes restantes et secondes avant la réinitialisation de la fenêtre.",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Policy": {
                "description": "Requêtes autorisées par fenêtre, par application.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Requête invalide : `validation_failed` liste les champs invalides.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Jeton absent, invalide ou expiré, ou accès du membre à l'application terminé (`invalid_token`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Portée manquante (`insufficient_scope`), membre en lecture seule (`readonly_member`), ou action que l'abonnement de l'organisation refuse.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Introuvable dans l'organisation à laquelle le jeton est lié (`not_found`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Conflit : une requête avec la même `Idempotency-Key` est encore en cours.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Cette `Idempotency-Key` a servi à une autre requête.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Limite de débit atteinte (`rate_limited`) ; réessayez après `Retry-After` secondes.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Erreur inattendue (`internal_error`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          }
        },
        "security": [
          {
            "oauth2": [
              "lexopti:read"
            ]
          }
        ],
        "x-codeSamples": [
          {
            "lang": "typescript",
            "label": "TypeScript",
            "source": "import { createLexOptiClient } from \"@lexopti/sdk\";\n\nconst lexopti = createLexOptiClient({ accessToken: () => process.env.LEXOPTI_TOKEN ?? \"\" });\n\nconst page = await lexopti.checks.list({\n\tclient_id: \"6f1b8d6e-2c4a-4f5e-9b1d-3a7c2e8f4d10\",\n});\nconsole.log(page.data.map((check) => check.status));"
          },
          {
            "lang": "curl",
            "label": "curl",
            "source": "curl -X GET \"https://app.lexopti.com/v1/checks\" \\\n  -H \"Authorization: Bearer $LEXOPTI_TOKEN\""
          },
          {
            "lang": "php",
            "label": "PHP",
            "source": "$response = (new GuzzleHttp\\Client())->request('GET', 'https://app.lexopti.com/v1/checks', [\n    'headers' => ['Authorization' => 'Bearer ' . getenv('LEXOPTI_TOKEN')],\n]);"
          }
        ]
      },
      "post": {
        "operationId": "checks.create",
        "summary": "Lancer une analyse",
        "description": "Analyse le client et ses parties liées sur l'ensemble des sources, comme le lancement de l'application : l'identité doit être complète, et l'analyse est facturée au dossier du client (`case_id`, ou son seul dossier ouvert) comme l'application la facture : gratuite dans l'année payée du dossier et pour les personnes déjà comptées, un crédit de plus par tranche de cinq personnes ou sociétés supplémentaires, une nouvelle année une fois la précédente finie (`quota_exceeded` si le solde ne peut pas la payer, `subscription_inactive` sans offre en cours). Asynchrone : suivez l'analyse, ou attendez `check.completed` / `check.failed`. Exige une `Idempotency-Key`.",
        "tags": [
          "Checks"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "client_id": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Le client à analyser. Son identité doit être assez complète : date de naissance et nationalité d'une personne, SIREN et pays d'une société française (sinon `incomplete_identity`)."
                  },
                  "case_id": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Le dossier ouvert du client auquel l'analyse est facturée. Par défaut, le seul dossier ouvert du client. S'il n'en a aucun, LexOpti lui ouvre d'abord un dossier « Relation d'affaires », comme le fait sa fiche client, et le facture. S'il en a plusieurs, l'analyse est refusée (`dossier_required`, avec la liste des dossiers pour choisir)."
                  }
                },
                "required": [
                  "client_id"
                ]
              },
              "examples": {
                "screen_a_client": {
                  "summary": "Analyser un client",
                  "value": {
                    "client_id": "6f1b8d6e-2c4a-4f5e-9b1d-3a7c2e8f4d10"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "202": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Check"
                }
              }
            },
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              },
              "RateLimit": {
                "description": "Requêtes restantes et secondes avant la réinitialisation de la fenêtre.",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Policy": {
                "description": "Requêtes autorisées par fenêtre, par application.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Requête invalide : `validation_failed` liste les champs invalides.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Jeton absent, invalide ou expiré, ou accès du membre à l'application terminé (`invalid_token`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Portée manquante (`insufficient_scope`), membre en lecture seule (`readonly_member`), ou action que l'abonnement de l'organisation refuse.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Introuvable dans l'organisation à laquelle le jeton est lié (`not_found`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Conflit : une requête avec la même `Idempotency-Key` est encore en cours (`idempotency_request_in_progress`), ou le lancement du contrôle est encore en cours (`check_launch_in_progress`) : réessayez plus tard avec la même clé et le même corps.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Cette `Idempotency-Key` a servi à une autre requête.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Limite de débit atteinte (`rate_limited`) ; réessayez après `Retry-After` secondes.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Erreur inattendue (`internal_error`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          }
        },
        "security": [
          {
            "oauth2": [
              "lexopti:write"
            ]
          }
        ],
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Clé unique de cette requête (un UUID) : une nouvelle tentative avec la même clé et le même corps reçoit la première réponse.",
            "schema": {
              "type": "string",
              "maxLength": 255
            }
          }
        ],
        "x-codeSamples": [
          {
            "lang": "typescript",
            "label": "TypeScript",
            "source": "import { createLexOptiClient } from \"@lexopti/sdk\";\n\nconst lexopti = createLexOptiClient({ accessToken: () => process.env.LEXOPTI_TOKEN ?? \"\" });\n\nconst check = await lexopti.checks.create({\n\tclient_id: \"6f1b8d6e-2c4a-4f5e-9b1d-3a7c2e8f4d10\",\n});\nconsole.log(check.id, check.status);"
          },
          {
            "lang": "curl",
            "label": "curl",
            "source": "curl -X POST \"https://app.lexopti.com/v1/checks\" \\\n  -H \"Authorization: Bearer $LEXOPTI_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Idempotency-Key: $(uuidgen)\" \\\n  -d '{\n    \"client_id\": \"6f1b8d6e-2c4a-4f5e-9b1d-3a7c2e8f4d10\"\n  }'"
          },
          {
            "lang": "php",
            "label": "PHP",
            "source": "$response = (new GuzzleHttp\\Client())->request('POST', 'https://app.lexopti.com/v1/checks', [\n    'headers' => ['Authorization' => 'Bearer ' . getenv('LEXOPTI_TOKEN'), 'Idempotency-Key' => uniqid('', true)],\n    'json' => [\n        'client_id' => '6f1b8d6e-2c4a-4f5e-9b1d-3a7c2e8f4d10',\n    ],\n]);"
          }
        ]
      }
    },
    "/checks/{id}": {
      "get": {
        "operationId": "checks.get",
        "summary": "Lire une analyse",
        "description": "Une analyse, avec le statut de chaque source. Lisez le client pour les résultats une fois l'analyse terminée.",
        "tags": [
          "Checks"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "L'identifiant LexOpti, tel que la création ou une liste l'a renvoyé (retrouvez un client ou un dossier par votre propre référence avec `?external_ref=`)."
            },
            "description": "L'identifiant LexOpti, tel que la création ou une liste l'a renvoyé (retrouvez un client ou un dossier par votre propre référence avec `?external_ref=`)."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Check"
                }
              }
            },
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              },
              "RateLimit": {
                "description": "Requêtes restantes et secondes avant la réinitialisation de la fenêtre.",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Policy": {
                "description": "Requêtes autorisées par fenêtre, par application.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Requête invalide : `validation_failed` liste les champs invalides.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Jeton absent, invalide ou expiré, ou accès du membre à l'application terminé (`invalid_token`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Portée manquante (`insufficient_scope`), membre en lecture seule (`readonly_member`), ou action que l'abonnement de l'organisation refuse.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Introuvable dans l'organisation à laquelle le jeton est lié (`not_found`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Conflit : une requête avec la même `Idempotency-Key` est encore en cours.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Cette `Idempotency-Key` a servi à une autre requête.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Limite de débit atteinte (`rate_limited`) ; réessayez après `Retry-After` secondes.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Erreur inattendue (`internal_error`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          }
        },
        "security": [
          {
            "oauth2": [
              "lexopti:read"
            ]
          }
        ],
        "x-codeSamples": [
          {
            "lang": "typescript",
            "label": "TypeScript",
            "source": "import { createLexOptiClient } from \"@lexopti/sdk\";\n\nconst lexopti = createLexOptiClient({ accessToken: () => process.env.LEXOPTI_TOKEN ?? \"\" });\n\nconst check = await lexopti.checks.get({\n\tid: \"chk_4b8e1f0a9c7d6e5b3a2f1e0d9c8b7a6f\",\n});\nfor (const source of check.sources) {\n\tconsole.log(source.source, source.status);\n}"
          },
          {
            "lang": "curl",
            "label": "curl",
            "source": "curl -X GET \"https://app.lexopti.com/v1/checks/:id\" \\\n  -H \"Authorization: Bearer $LEXOPTI_TOKEN\""
          },
          {
            "lang": "php",
            "label": "PHP",
            "source": "$response = (new GuzzleHttp\\Client())->request('GET', 'https://app.lexopti.com/v1/checks/:id', [\n    'headers' => ['Authorization' => 'Bearer ' . getenv('LEXOPTI_TOKEN')],\n]);"
          }
        ]
      }
    },
    "/clients": {
      "get": {
        "operationId": "clients.list",
        "summary": "Lister les clients",
        "description": "Les clients de l'organisation, du plus récent au plus ancien. Filtrez une page de vos fiches en une requête (`external_ref` ou `ids`, séparés par des virgules) et ajoutez ce que vos écrans montrent avec `expand[]`.",
        "tags": [
          "Clients"
        ],
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 25,
              "description": "Taille de page, de 1 à 100."
            },
            "allowEmptyValue": true,
            "allowReserved": true,
            "description": "Taille de page, de 1 à 100."
          },
          {
            "name": "cursor",
            "in": "query",
            "schema": {
              "type": "string",
              "description": "`next_cursor` de la page précédente ; à omettre pour la première page."
            },
            "allowEmptyValue": true,
            "allowReserved": true,
            "description": "`next_cursor` de la page précédente ; à omettre pour la première page."
          },
          {
            "name": "external_ref",
            "in": "query",
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9:._-]{1,255}(?:,[A-Za-z0-9:._-]{1,255}){0,99}$",
              "description": "Seulement les clients portant ces références de votre application, séparées par des virgules (100 au plus) : `crm:contact:1,crm:contact:2`. Une référence inconnue est ignorée ; aucune connue donne une page vide."
            },
            "allowEmptyValue": true,
            "allowReserved": true,
            "description": "Seulement les clients portant ces références de votre application, séparées par des virgules (100 au plus) : `crm:contact:1,crm:contact:2`. Une référence inconnue est ignorée ; aucune connue donne une page vide."
          },
          {
            "name": "ids",
            "in": "query",
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{1,64}(?:,[A-Za-z0-9_-]{1,64}){0,99}$",
              "description": "Seulement ces clients, par leur identifiant LexOpti, séparés par des virgules (100 au plus). Un identifiant d'une autre organisation est ignoré, comme un inconnu."
            },
            "allowEmptyValue": true,
            "allowReserved": true,
            "description": "Seulement ces clients, par leur identifiant LexOpti, séparés par des virgules (100 au plus). Un identifiant d'une autre organisation est ignoré, comme un inconnu."
          },
          {
            "name": "expand",
            "in": "query",
            "schema": {
              "type": "array",
              "maxItems": 16,
              "items": {
                "enum": [
                  "last_check",
                  "open_alerts_count",
                  "classification_state",
                  "cases"
                ],
                "type": "string",
                "description": "`last_check` : la dernière analyse du client ; `open_alerts_count` : ses alertes en attente de l'examen d'un membre ; `classification_state` : l'état de sa classification ; `cases` : ses derniers dossiers, avec leur niveau de risque validé."
              },
              "description": "Champs à ajouter à chaque client, envoyés ainsi : `expand[]=last_check&expand[]=cases` (comme l'`expand[]` de Stripe) : un `expand=cases` seul est refusé, un champ répété compte une fois. `cases` et `classification_state` pèsent dans la limite de débit avec la page qu'ils complètent. Une requête lit alors toute une page de fiches : lisez-la une fois, gardez-la, et suivez les webhooks plutôt que de relire à chaque page affichée."
            },
            "style": "deepObject",
            "explode": true,
            "allowEmptyValue": true,
            "allowReserved": true,
            "description": "Champs à ajouter à chaque client, envoyés ainsi : `expand[]=last_check&expand[]=cases` (comme l'`expand[]` de Stripe) : un `expand=cases` seul est refusé, un champ répété compte une fois. `cases` et `classification_state` pèsent dans la limite de débit avec la page qu'ils complètent. Une requête lit alors toute une page de fiches : lisez-la une fois, gardez-la, et suivez les webhooks plutôt que de relire à chaque page affichée."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Client"
                      }
                    },
                    "has_more": {
                      "type": "boolean"
                    },
                    "next_cursor": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "À passer en `cursor` pour lire la page suivante ; null sur la dernière."
                    }
                  },
                  "required": [
                    "data",
                    "has_more",
                    "next_cursor"
                  ]
                }
              }
            },
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              },
              "RateLimit": {
                "description": "Requêtes restantes et secondes avant la réinitialisation de la fenêtre.",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Policy": {
                "description": "Requêtes autorisées par fenêtre, par application.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Requête invalide : `validation_failed` liste les champs invalides.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Jeton absent, invalide ou expiré, ou accès du membre à l'application terminé (`invalid_token`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Portée manquante (`insufficient_scope`), membre en lecture seule (`readonly_member`), ou action que l'abonnement de l'organisation refuse.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Introuvable dans l'organisation à laquelle le jeton est lié (`not_found`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Conflit : une requête avec la même `Idempotency-Key` est encore en cours.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Cette `Idempotency-Key` a servi à une autre requête.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Limite de débit atteinte (`rate_limited`) ; réessayez après `Retry-After` secondes.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Erreur inattendue (`internal_error`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          }
        },
        "security": [
          {
            "oauth2": [
              "lexopti:read"
            ]
          }
        ],
        "x-codeSamples": [
          {
            "lang": "typescript",
            "label": "TypeScript",
            "source": "import { createLexOptiClient } from \"@lexopti/sdk\";\n\nconst lexopti = createLexOptiClient({ accessToken: () => process.env.LEXOPTI_TOKEN ?? \"\" });\n\nconst page = await lexopti.clients.list({\n\texternal_ref: [\"crm:contact:1042\", \"crm:contact:1043\"].join(\",\"),\n\texpand: [\"last_check\", \"open_alerts_count\", \"classification_state\"],\n\tlimit: 100,\n});\nfor (const client of page.data) {\n\tconsole.log(client.external_ref, client.vigilance_level);\n\tconsole.log(client.last_check?.status, client.open_alerts_count);\n}"
          },
          {
            "lang": "curl",
            "label": "curl",
            "source": "curl -X GET \"https://app.lexopti.com/v1/clients\" \\\n  -H \"Authorization: Bearer $LEXOPTI_TOKEN\""
          },
          {
            "lang": "php",
            "label": "PHP",
            "source": "$response = (new GuzzleHttp\\Client())->request('GET', 'https://app.lexopti.com/v1/clients', [\n    'headers' => ['Authorization' => 'Bearer ' . getenv('LEXOPTI_TOKEN')],\n]);"
          }
        ]
      },
      "post": {
        "operationId": "clients.create",
        "summary": "Créer un client",
        "description": "Enregistre un client sans lancer d'analyse. Exige une `Idempotency-Key`.",
        "tags": [
          "Clients"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {
                      "type": {
                        "const": "person",
                        "description": "`person` ou `company` : envoyez l'objet correspondant, `person` ou `company`."
                      },
                      "person": {
                        "type": "object",
                        "properties": {
                          "first_name": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 255,
                            "description": "Prénom(s), comme sur la pièce d'identité. Exemple : `Camille`."
                          },
                          "last_name": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 255,
                            "description": "Nom de famille, comme sur la pièce d'identité. Exemple : `Durand`."
                          },
                          "usage_name": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 255,
                            "description": "Nom d'usage, quand il diffère de `last_name` (par exemple un nom d'épouse). Exemple : `Martin`."
                          },
                          "birth_date": {
                            "type": "string",
                            "format": "date",
                            "description": "Date de naissance, `AAAA-MM-JJ`. Nécessaire pour lancer une analyse (sinon `incomplete_identity`). Exemple : `1980-02-01`."
                          },
                          "birth_city": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 255,
                            "description": "Ville de naissance. Exemple : `Lyon`."
                          },
                          "birth_country": {
                            "type": "string",
                            "pattern": "^[A-Za-z]{2}$",
                            "description": "Pays de naissance : code ISO 3166-1 alpha-2 (`FR`, pas `France`), mis en majuscules par LexOpti. Exemple : `FR`."
                          },
                          "nationalities": {
                            "type": "array",
                            "maxItems": 10,
                            "items": {
                              "type": "string",
                              "pattern": "^[A-Za-z]{2}$"
                            },
                            "description": "Nationalités : codes ISO 3166-1 alpha-2 (`FR`, pas `France`), mis en majuscules par LexOpti, 10 au plus. Il en faut au moins une pour lancer une analyse (sinon `incomplete_identity`) : l'analyse les compare aux nationalités des listes de sanctions et des personnes politiquement exposées (PPE). Exemple : `[\"FR\"]`."
                          }
                        },
                        "required": [
                          "first_name",
                          "last_name"
                        ],
                        "description": "L'identité de la personne, avec `type: person`."
                      },
                      "address": {
                        "type": "object",
                        "properties": {
                          "line": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 255,
                            "description": "Numéro, voie et complément éventuel. Exemple : `12 rue de la Paix`."
                          },
                          "postal_code": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 255,
                            "description": "Code postal. Exemple : `75002`."
                          },
                          "city": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 255,
                            "description": "Ville. Exemple : `Paris`."
                          },
                          "country": {
                            "type": "string",
                            "pattern": "^[A-Za-z]{2}$",
                            "description": "Pays : code ISO 3166-1 alpha-2 (`FR`, pas `France`), mis en majuscules par LexOpti. Exemple : `FR`."
                          }
                        },
                        "description": "L'adresse postale. Facultative."
                      },
                      "external_ref": {
                        "type": "string",
                        "pattern": "^[A-Za-z0-9:._-]{1,255}$",
                        "description": "Votre référence pour le nouveau client, liée lors de sa création : une référence déjà utilisée répond 409 `external_ref_conflict` et rien n'est créé."
                      }
                    },
                    "required": [
                      "type",
                      "person"
                    ]
                  },
                  {
                    "type": "object",
                    "properties": {
                      "type": {
                        "const": "company",
                        "description": "`person` ou `company` : envoyez l'objet correspondant, `person` ou `company`."
                      },
                      "company": {
                        "type": "object",
                        "properties": {
                          "name": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 255,
                            "description": "Dénomination sociale. Exemple : `Atelier Durand`."
                          },
                          "siren": {
                            "type": "string",
                            "pattern": "^\\d{9}$",
                            "description": "SIREN : neuf chiffres, sans espaces. Avec `registration_country`, nécessaire pour lancer une analyse sur une société française. Exemple : `552100554`."
                          },
                          "siret": {
                            "type": "string",
                            "pattern": "^\\d{14}$",
                            "description": "SIRET d'un de ses établissements : 14 chiffres, sans espaces. Exemple : `55210055400013`."
                          },
                          "legal_form": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 255,
                            "description": "Forme juridique, en général son abréviation. Exemple : `SAS`."
                          },
                          "registration_country": {
                            "type": "string",
                            "pattern": "^[A-Za-z]{2}$",
                            "description": "Pays d'immatriculation : code ISO 3166-1 alpha-2 (`FR`, pas `France`), mis en majuscules par LexOpti. Exemple : `FR`."
                          },
                          "rcs": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 255,
                            "description": "Immatriculation au RCS, comme sur le Kbis. Exemple : `Nice B 552 100 554`."
                          }
                        },
                        "required": [
                          "name"
                        ],
                        "description": "L'identité de la société, avec `type: company`."
                      },
                      "address": {
                        "type": "object",
                        "properties": {
                          "line": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 255,
                            "description": "Numéro, voie et complément éventuel. Exemple : `12 rue de la Paix`."
                          },
                          "postal_code": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 255,
                            "description": "Code postal. Exemple : `75002`."
                          },
                          "city": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 255,
                            "description": "Ville. Exemple : `Paris`."
                          },
                          "country": {
                            "type": "string",
                            "pattern": "^[A-Za-z]{2}$",
                            "description": "Pays : code ISO 3166-1 alpha-2 (`FR`, pas `France`), mis en majuscules par LexOpti. Exemple : `FR`."
                          }
                        },
                        "description": "L'adresse postale. Facultative."
                      },
                      "external_ref": {
                        "type": "string",
                        "pattern": "^[A-Za-z0-9:._-]{1,255}$",
                        "description": "Votre référence pour le nouveau client, liée lors de sa création : une référence déjà utilisée répond 409 `external_ref_conflict` et rien n'est créé."
                      }
                    },
                    "required": [
                      "type",
                      "company"
                    ]
                  }
                ],
                "description": "L'identité du client. Créer un client ne lance aucune analyse et ne coûte aucun crédit : lancez une analyse dans l'un de ses dossiers. Quand l'offre d'intégration de l'organisation l'inclut, une analyse préliminaire gratuite des listes officielles de gels et de sanctions suit (`preliminary_screening`)."
              },
              "examples": {
                "a_person": {
                  "summary": "Une personne",
                  "value": {
                    "type": "person",
                    "person": {
                      "first_name": "Camille",
                      "last_name": "Durand",
                      "birth_date": "1980-02-01",
                      "birth_city": "Lyon",
                      "birth_country": "FR",
                      "nationalities": [
                        "FR"
                      ]
                    },
                    "address": {
                      "line": "12 rue de la Paix",
                      "postal_code": "75002",
                      "city": "Paris",
                      "country": "FR"
                    },
                    "external_ref": "crm:contact:1042"
                  }
                },
                "a_company": {
                  "summary": "Une société",
                  "value": {
                    "type": "company",
                    "company": {
                      "name": "Atelier Durand",
                      "siren": "552100554",
                      "legal_form": "SAS",
                      "registration_country": "FR",
                      "rcs": "Paris B 552 100 554"
                    },
                    "address": {
                      "line": "12 rue de la Paix",
                      "postal_code": "75002",
                      "city": "Paris",
                      "country": "FR"
                    },
                    "external_ref": "crm:account:77"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Client"
                }
              }
            },
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              },
              "RateLimit": {
                "description": "Requêtes restantes et secondes avant la réinitialisation de la fenêtre.",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Policy": {
                "description": "Requêtes autorisées par fenêtre, par application.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Requête invalide : `validation_failed` liste les champs invalides.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Jeton absent, invalide ou expiré, ou accès du membre à l'application terminé (`invalid_token`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Portée manquante (`insufficient_scope`), membre en lecture seule (`readonly_member`), ou action que l'abonnement de l'organisation refuse.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Introuvable dans l'organisation à laquelle le jeton est lié (`not_found`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Conflit : une requête avec la même `Idempotency-Key` est encore en cours (`idempotency_request_in_progress`), ou l'`external_ref` désigne déjà un autre client de votre application (`external_ref_conflict`), et rien n'est alors créé : retrouvez ce client avec `GET /v1/clients?external_ref=`.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Cette `Idempotency-Key` a servi à une autre requête.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Limite de débit atteinte (`rate_limited`) ; réessayez après `Retry-After` secondes.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Erreur inattendue (`internal_error`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          }
        },
        "security": [
          {
            "oauth2": [
              "lexopti:write"
            ]
          }
        ],
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Clé unique de cette requête (un UUID) : une nouvelle tentative avec la même clé et le même corps reçoit la première réponse.",
            "schema": {
              "type": "string",
              "maxLength": 255
            }
          }
        ],
        "x-codeSamples": [
          {
            "lang": "typescript",
            "label": "TypeScript",
            "source": "import { createLexOptiClient } from \"@lexopti/sdk\";\n\nconst lexopti = createLexOptiClient({ accessToken: () => process.env.LEXOPTI_TOKEN ?? \"\" });\n\nconst client = await lexopti.clients.create({\n\ttype: \"company\",\n\tcompany: {\n\t\tname: \"Durand SAS\",\n\t\tsiren: \"552100554\",\n\t\tregistration_country: \"FR\",\n\t},\n\taddress: { city: \"Nice\", country: \"FR\" },\n\t// Your own id for the client, to find it again without storing ours.\n\texternal_ref: \"crm:company:2201\",\n});\nconsole.log(client.id, client.external_ref, client.monitoring_enabled);"
          },
          {
            "lang": "curl",
            "label": "curl",
            "source": "curl -X POST \"https://app.lexopti.com/v1/clients\" \\\n  -H \"Authorization: Bearer $LEXOPTI_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Idempotency-Key: $(uuidgen)\" \\\n  -d '{\n    \"type\": \"person\",\n    \"person\": {\n      \"first_name\": \"Camille\",\n      \"last_name\": \"Durand\",\n      \"birth_date\": \"1980-02-01\",\n      \"birth_city\": \"Lyon\",\n      \"birth_country\": \"FR\",\n      \"nationalities\": [\n        \"FR\"\n      ]\n    },\n    \"address\": {\n      \"line\": \"12 rue de la Paix\",\n      \"postal_code\": \"75002\",\n      \"city\": \"Paris\",\n      \"country\": \"FR\"\n    },\n    \"external_ref\": \"crm:contact:1042\"\n  }'"
          },
          {
            "lang": "php",
            "label": "PHP",
            "source": "$response = (new GuzzleHttp\\Client())->request('POST', 'https://app.lexopti.com/v1/clients', [\n    'headers' => ['Authorization' => 'Bearer ' . getenv('LEXOPTI_TOKEN'), 'Idempotency-Key' => uniqid('', true)],\n    'json' => [\n        'type' => 'person',\n        'person' => [\n            'first_name' => 'Camille',\n            'last_name' => 'Durand',\n            'birth_date' => '1980-02-01',\n            'birth_city' => 'Lyon',\n            'birth_country' => 'FR',\n            'nationalities' => [\n                'FR',\n            ],\n        ],\n        'address' => [\n            'line' => '12 rue de la Paix',\n            'postal_code' => '75002',\n            'city' => 'Paris',\n            'country' => 'FR',\n        ],\n        'external_ref' => 'crm:contact:1042',\n    ],\n]);"
          }
        ]
      }
    },
    "/clients/{id}": {
      "get": {
        "operationId": "clients.get",
        "summary": "Lire un client",
        "description": "Un client de l'organisation, avec son identité et ses niveaux.",
        "tags": [
          "Clients"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "L'identifiant LexOpti, tel que la création ou une liste l'a renvoyé (retrouvez un client ou un dossier par votre propre référence avec `?external_ref=`)."
            },
            "description": "L'identifiant LexOpti, tel que la création ou une liste l'a renvoyé (retrouvez un client ou un dossier par votre propre référence avec `?external_ref=`)."
          },
          {
            "name": "expand",
            "in": "query",
            "schema": {
              "type": "array",
              "maxItems": 16,
              "items": {
                "enum": [
                  "last_check",
                  "open_alerts_count",
                  "classification_state",
                  "cases"
                ],
                "type": "string",
                "description": "`last_check` : la dernière analyse du client ; `open_alerts_count` : ses alertes en attente de l'examen d'un membre ; `classification_state` : l'état de sa classification ; `cases` : ses derniers dossiers, avec leur niveau de risque validé."
              },
              "description": "Champs à ajouter à chaque client, envoyés ainsi : `expand[]=last_check&expand[]=cases` (comme l'`expand[]` de Stripe) : un `expand=cases` seul est refusé, un champ répété compte une fois. `cases` et `classification_state` pèsent dans la limite de débit avec la page qu'ils complètent. Une requête lit alors toute une page de fiches : lisez-la une fois, gardez-la, et suivez les webhooks plutôt que de relire à chaque page affichée."
            },
            "style": "deepObject",
            "explode": true,
            "allowEmptyValue": true,
            "allowReserved": true,
            "description": "Champs à ajouter à chaque client, envoyés ainsi : `expand[]=last_check&expand[]=cases` (comme l'`expand[]` de Stripe) : un `expand=cases` seul est refusé, un champ répété compte une fois. `cases` et `classification_state` pèsent dans la limite de débit avec la page qu'ils complètent. Une requête lit alors toute une page de fiches : lisez-la une fois, gardez-la, et suivez les webhooks plutôt que de relire à chaque page affichée."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Client"
                }
              }
            },
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              },
              "RateLimit": {
                "description": "Requêtes restantes et secondes avant la réinitialisation de la fenêtre.",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Policy": {
                "description": "Requêtes autorisées par fenêtre, par application.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Requête invalide : `validation_failed` liste les champs invalides.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Jeton absent, invalide ou expiré, ou accès du membre à l'application terminé (`invalid_token`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Portée manquante (`insufficient_scope`), membre en lecture seule (`readonly_member`), ou action que l'abonnement de l'organisation refuse.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Introuvable dans l'organisation à laquelle le jeton est lié (`not_found`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Conflit : une requête avec la même `Idempotency-Key` est encore en cours.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Cette `Idempotency-Key` a servi à une autre requête.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Limite de débit atteinte (`rate_limited`) ; réessayez après `Retry-After` secondes.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Erreur inattendue (`internal_error`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          }
        },
        "security": [
          {
            "oauth2": [
              "lexopti:read"
            ]
          }
        ],
        "x-codeSamples": [
          {
            "lang": "typescript",
            "label": "TypeScript",
            "source": "import { createLexOptiClient } from \"@lexopti/sdk\";\n\nconst lexopti = createLexOptiClient({ accessToken: () => process.env.LEXOPTI_TOKEN ?? \"\" });\n\nconst client = await lexopti.clients.get({\n\tid: \"6f1b8d6e-2c4a-4f5e-9b1d-3a7c2e8f4d10\",\n});\nconsole.log(client.name, client.vigilance_level, client.risk_level);"
          },
          {
            "lang": "curl",
            "label": "curl",
            "source": "curl -X GET \"https://app.lexopti.com/v1/clients/:id\" \\\n  -H \"Authorization: Bearer $LEXOPTI_TOKEN\""
          },
          {
            "lang": "php",
            "label": "PHP",
            "source": "$response = (new GuzzleHttp\\Client())->request('GET', 'https://app.lexopti.com/v1/clients/:id', [\n    'headers' => ['Authorization' => 'Bearer ' . getenv('LEXOPTI_TOKEN')],\n]);"
          }
        ]
      },
      "patch": {
        "operationId": "clients.update",
        "summary": "Modifier un client",
        "description": "Modifie l'identité du client avec les règles de l'application : un client analysé garde ses champs d'identité obligatoires (`incomplete_identity`), et la modification d'un champ analysé d'un client en vigilance continue lance aussitôt sa réanalyse, comme dans l'application, facturée aux dossiers où il a été analysé : il compte une fois de plus dans chacune, gratuitement tant que leurs places payées le couvrent (`quota_exceeded` si les crédits ne peuvent pas la payer, rien n'est modifié). Complète une identité qu'une analyse a refusée (`incomplete_identity`). Idempotent : le même corps ne modifie, ne lance et ne facture plus rien. Envoie `client.updated` avec les champs modifiés.",
        "tags": [
          "Clients"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "L'identifiant LexOpti, tel que la création ou une liste l'a renvoyé (retrouvez un client ou un dossier par votre propre référence avec `?external_ref=`)."
            },
            "description": "L'identifiant LexOpti, tel que la création ou une liste l'a renvoyé (retrouvez un client ou un dossier par votre propre référence avec `?external_ref=`)."
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "person": {
                    "type": "object",
                    "properties": {
                      "first_name": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 255,
                        "description": "Prénom(s), comme sur la pièce d'identité. Exemple : `Camille`."
                      },
                      "last_name": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 255,
                        "description": "Nom de famille, comme sur la pièce d'identité. Exemple : `Durand`."
                      },
                      "usage_name": {
                        "anyOf": [
                          {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 255
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Nom d'usage, quand il diffère de `last_name` (par exemple un nom d'épouse). Exemple : `Martin`."
                      },
                      "birth_date": {
                        "anyOf": [
                          {
                            "type": "string",
                            "format": "date"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Date de naissance, `AAAA-MM-JJ`. Nécessaire pour lancer une analyse (sinon `incomplete_identity`). Exemple : `1980-02-01`."
                      },
                      "birth_city": {
                        "anyOf": [
                          {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 255
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Ville de naissance. Exemple : `Lyon`."
                      },
                      "birth_country": {
                        "anyOf": [
                          {
                            "type": "string",
                            "pattern": "^[A-Za-z]{2}$"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Pays de naissance : code ISO 3166-1 alpha-2 (`FR`, pas `France`), mis en majuscules par LexOpti. Exemple : `FR`."
                      },
                      "nationalities": {
                        "anyOf": [
                          {
                            "type": "array",
                            "maxItems": 10,
                            "items": {
                              "type": "string",
                              "pattern": "^[A-Za-z]{2}$"
                            }
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Nationalités : codes ISO 3166-1 alpha-2 (`FR`, pas `France`), mis en majuscules par LexOpti, 10 au plus. Il en faut au moins une pour lancer une analyse (sinon `incomplete_identity`) : l'analyse les compare aux nationalités des listes de sanctions et des personnes politiquement exposées (PPE). Exemple : `[\"FR\"]`. Remplace toute la liste ; `null` ou `[]` la vide."
                      }
                    },
                    "additionalProperties": false,
                    "description": "Pour une personne seulement."
                  },
                  "company": {
                    "type": "object",
                    "properties": {
                      "name": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 255,
                        "description": "Dénomination sociale. Exemple : `Atelier Durand`."
                      },
                      "siren": {
                        "anyOf": [
                          {
                            "type": "string",
                            "pattern": "^\\d{9}$"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "SIREN : neuf chiffres, sans espaces. Avec `registration_country`, nécessaire pour lancer une analyse sur une société française. Exemple : `552100554`."
                      },
                      "siret": {
                        "anyOf": [
                          {
                            "type": "string",
                            "pattern": "^\\d{14}$"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "SIRET d'un de ses établissements : 14 chiffres, sans espaces. Exemple : `55210055400013`."
                      },
                      "legal_form": {
                        "anyOf": [
                          {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 255
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Forme juridique, en général son abréviation. Exemple : `SAS`."
                      },
                      "registration_country": {
                        "anyOf": [
                          {
                            "type": "string",
                            "pattern": "^[A-Za-z]{2}$"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Pays d'immatriculation : code ISO 3166-1 alpha-2 (`FR`, pas `France`), mis en majuscules par LexOpti. Exemple : `FR`."
                      },
                      "rcs": {
                        "anyOf": [
                          {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 255
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Immatriculation au RCS, comme sur le Kbis. Exemple : `Nice B 552 100 554`."
                      }
                    },
                    "additionalProperties": false,
                    "description": "Pour une société seulement."
                  },
                  "address": {
                    "type": "object",
                    "properties": {
                      "line": {
                        "anyOf": [
                          {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 255
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Numéro, voie et complément éventuel. Exemple : `12 rue de la Paix`."
                      },
                      "postal_code": {
                        "anyOf": [
                          {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 255
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Code postal. Exemple : `75002`."
                      },
                      "city": {
                        "anyOf": [
                          {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 255
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Ville. Exemple : `Paris`."
                      },
                      "country": {
                        "anyOf": [
                          {
                            "type": "string",
                            "pattern": "^[A-Za-z]{2}$"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Code ISO 3166-1 alpha-2 (`FR`, pas `France`) ; pour une personne seulement (le pays d'une société est `company.registration_country`)."
                      }
                    },
                    "additionalProperties": false,
                    "description": "Pour une personne ou une société."
                  }
                },
                "additionalProperties": false
              },
              "examples": {
                "complete_an_identity": {
                  "summary": "Compléter une identité",
                  "value": {
                    "person": {
                      "birth_date": "1980-02-01",
                      "nationalities": [
                        "FR"
                      ]
                    },
                    "address": {
                      "line": "12 rue de la Paix",
                      "postal_code": "75002"
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Client"
                }
              }
            },
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              },
              "RateLimit": {
                "description": "Requêtes restantes et secondes avant la réinitialisation de la fenêtre.",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Policy": {
                "description": "Requêtes autorisées par fenêtre, par application.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Requête invalide : `validation_failed` liste les champs invalides.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Jeton absent, invalide ou expiré, ou accès du membre à l'application terminé (`invalid_token`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Portée manquante (`insufficient_scope`), membre en lecture seule (`readonly_member`), ou action que l'abonnement de l'organisation refuse.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Introuvable dans l'organisation à laquelle le jeton est lié (`not_found`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Conflit : une requête avec la même `Idempotency-Key` est encore en cours.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Cette `Idempotency-Key` a servi à une autre requête.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Limite de débit atteinte (`rate_limited`) ; réessayez après `Retry-After` secondes.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Erreur inattendue (`internal_error`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          }
        },
        "security": [
          {
            "oauth2": [
              "lexopti:write"
            ]
          }
        ],
        "x-codeSamples": [
          {
            "lang": "typescript",
            "label": "TypeScript",
            "source": "import { createLexOptiClient } from \"@lexopti/sdk\";\n\nconst lexopti = createLexOptiClient({ accessToken: () => process.env.LEXOPTI_TOKEN ?? \"\" });\n\nconst client = await lexopti.clients.update({\n\tid: \"6f1b8d6e-2c4a-4f5e-9b1d-3a7c2e8f4d10\",\n\tcompany: { legal_form: \"SAS\", rcs: \"Nice B 552 100 554\" },\n\t// null clears an optional field.\n\taddress: { line: \"12 avenue Jean Médecin\", postal_code: \"06000\" },\n});\nconsole.log(client.company?.legal_form, client.address.postal_code);"
          },
          {
            "lang": "curl",
            "label": "curl",
            "source": "curl -X PATCH \"https://app.lexopti.com/v1/clients/:id\" \\\n  -H \"Authorization: Bearer $LEXOPTI_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Idempotency-Key: $(uuidgen)\" \\\n  -d '{\n    \"person\": {\n      \"birth_date\": \"1980-02-01\",\n      \"nationalities\": [\n        \"FR\"\n      ]\n    },\n    \"address\": {\n      \"line\": \"12 rue de la Paix\",\n      \"postal_code\": \"75002\"\n    }\n  }'"
          },
          {
            "lang": "php",
            "label": "PHP",
            "source": "$response = (new GuzzleHttp\\Client())->request('PATCH', 'https://app.lexopti.com/v1/clients/:id', [\n    'headers' => ['Authorization' => 'Bearer ' . getenv('LEXOPTI_TOKEN'), 'Idempotency-Key' => uniqid('', true)],\n    'json' => [\n        'person' => [\n            'birth_date' => '1980-02-01',\n            'nationalities' => [\n                'FR',\n            ],\n        ],\n        'address' => [\n            'line' => '12 rue de la Paix',\n            'postal_code' => '75002',\n        ],\n    ],\n]);"
          }
        ]
      }
    },
    "/clients/{id}/classification": {
      "get": {
        "operationId": "clients.getClassification",
        "summary": "Lire la classification du client",
        "description": "L'évaluation de risque propre au client telle qu'elle est enregistrée : les questions sur le client et les personnes qui lui sont liées (`axe2` du questionnaire appelé « classification TRACFIN » dans LexOpti). Son état, son score et son niveau de vigilance, sa dernière validation, ses réponses et les questions encore sans réponse. En lecture seule : seul un membre y répond et la valide, dans LexOpti ou ses écrans embarqués. La lecture ne modifie rien. Un client jamais évalué répond `to_complete`, sans réponses. [Glossaire](https://developers.lexopti.com/fr/glossary/).",
        "tags": [
          "Clients"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "L'identifiant LexOpti, tel que la création ou une liste l'a renvoyé (retrouvez un client ou un dossier par votre propre référence avec `?external_ref=`)."
            },
            "description": "L'identifiant LexOpti, tel que la création ou une liste l'a renvoyé (retrouvez un client ou un dossier par votre propre référence avec `?external_ref=`)."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Classification"
                }
              }
            },
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              },
              "RateLimit": {
                "description": "Requêtes restantes et secondes avant la réinitialisation de la fenêtre.",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Policy": {
                "description": "Requêtes autorisées par fenêtre, par application.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Requête invalide : `validation_failed` liste les champs invalides.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Jeton absent, invalide ou expiré, ou accès du membre à l'application terminé (`invalid_token`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Portée manquante (`insufficient_scope`), membre en lecture seule (`readonly_member`), ou action que l'abonnement de l'organisation refuse.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Introuvable dans l'organisation à laquelle le jeton est lié (`not_found`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Conflit : une requête avec la même `Idempotency-Key` est encore en cours.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Cette `Idempotency-Key` a servi à une autre requête.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Limite de débit atteinte (`rate_limited`) ; réessayez après `Retry-After` secondes.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Erreur inattendue (`internal_error`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          }
        },
        "security": [
          {
            "oauth2": [
              "lexopti:read"
            ]
          }
        ],
        "x-codeSamples": [
          {
            "lang": "typescript",
            "label": "TypeScript",
            "source": "import { createLexOptiClient } from \"@lexopti/sdk\";\n\nconst lexopti = createLexOptiClient({ accessToken: () => process.env.LEXOPTI_TOKEN ?? \"\" });\n\nconst classification = await lexopti.clients.getClassification({\n\tid: \"6f1b8d6e-2c4a-4f5e-9b1d-3a7c2e8f4d10\",\n});\nconsole.log(classification.state, classification.level);\nconsole.log(\n\t`${classification.missing_answers.count} question(s) to answer in LexOpti`\n);"
          },
          {
            "lang": "curl",
            "label": "curl",
            "source": "curl -X GET \"https://app.lexopti.com/v1/clients/:id/classification\" \\\n  -H \"Authorization: Bearer $LEXOPTI_TOKEN\""
          },
          {
            "lang": "php",
            "label": "PHP",
            "source": "$response = (new GuzzleHttp\\Client())->request('GET', 'https://app.lexopti.com/v1/clients/:id/classification', [\n    'headers' => ['Authorization' => 'Bearer ' . getenv('LEXOPTI_TOKEN')],\n]);"
          }
        ]
      }
    },
    "/clients/{id}/preliminary-screening": {
      "get": {
        "operationId": "clients.getPreliminaryScreening",
        "summary": "Lire l'analyse préliminaire du client",
        "description": "L'analyse préliminaire gratuite d'un client que votre application a créé par l'API ou demandée : son résultat actuel (la dernière recherche terminée) et sa dernière demande, qui peut être encore en attente. Un résultat indique les listes officielles de gels et de sanctions consultées avec la publication, l'éditeur et les conditions de réutilisation de chacune, les correspondances avec leurs références et liens officiels, et la date de sa dernière confirmation. LexOpti analyse de nouveau ce client, gratuitement, à chaque nouvelle publication des listes tant que l'organisation a une offre et que le client n'est pas en vigilance continue (`client.preliminary_screening_completed` signale un résultat changé). Gels et sanctions seulement : une correspondance possible sur une liste contraignante est à vérifier et, si elle est confirmée, les avoirs sont gelés et déclarés sans délai à la DG Trésor ; une correspondance OFAC est un risque de sanctions américaines à évaluer. 404 si le client n'en a pas.",
        "tags": [
          "Clients"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "L'identifiant LexOpti, tel que la création ou une liste l'a renvoyé (retrouvez un client ou un dossier par votre propre référence avec `?external_ref=`)."
            },
            "description": "L'identifiant LexOpti, tel que la création ou une liste l'a renvoyé (retrouvez un client ou un dossier par votre propre référence avec `?external_ref=`)."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "client_id": {
                      "type": "string",
                      "description": "Le client analysé."
                    },
                    "current": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "description": "L'identifiant de cette demande."
                            },
                            "status": {
                              "enum": [
                                "pending",
                                "completed",
                                "failed",
                                "unavailable"
                              ],
                              "type": "string",
                              "description": "`pending` : en attente ; `completed` : les listes ont été consultées (`outcome`) ; `failed` : l'identité n'a pas pu être recherchée (`error_code`) ; `unavailable` : les listes n'ont pas pu être consultées pour l'instant, LexOpti réessaie plus tard."
                            },
                            "outcome": {
                              "anyOf": [
                                {
                                  "enum": [
                                    "no_match",
                                    "possible_match"
                                  ],
                                  "type": "string",
                                  "description": "`no_match` : aucune correspondance dans les listes consultées, aux versions indiquées (jamais une attestation que le client est conforme ou non gelé) ; `possible_match` : au moins une personne ou entité inscrite peut être le client, à vérifier."
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Renseigné quand `status` vaut `completed`, null sinon."
                            },
                            "trigger": {
                              "enum": [
                                "initial",
                                "identity_change",
                                "requested",
                                "list_update"
                              ],
                              "type": "string",
                              "description": "`initial` : votre application a créé le client par l'API ; `identity_change` : votre application a modifié un champ d'identité analysé d'un tel client ; `requested` : votre application a demandé l'analyse (`POST /v1/clients/{id}/preliminary-screening`) ; `list_update` : une nouvelle publication des listes a changé le résultat."
                            },
                            "requested_at": {
                              "type": "string",
                              "format": "date-time",
                              "description": "Quand l'analyse a été demandée."
                            },
                            "screened_at": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "format": "date-time"
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Quand la recherche a eu lieu ; null si aucune n'a eu lieu (`pending`, `unavailable`, ou une identité qui n'a pas pu être recherchée)."
                            },
                            "checked_at": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "format": "date-time"
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Dernière fois que ce résultat a été confirmé sur une publication des listes ; null sauf si `completed`."
                            },
                            "error_code": {
                              "anyOf": [
                                {
                                  "type": "string"
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Pourquoi elle est `failed` ou `unavailable` : `unscreenable_subject` (aucun nom ni identifiant à rechercher), `saturated` (trop de candidats pour déclarer le client sans correspondance), `lists_not_indexed` (les listes ne sont pas encore consultables), `yente_unavailable` (le service de recherche n'a pas répondu), `screening_timeout` (la recherche n'a pas pu avoir lieu à temps), `sandbox_error` (le `ERREUR` du bac à sable). D'autres codes peuvent s'ajouter."
                            },
                            "lists": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "source": {
                                    "enum": [
                                      "fr_tresor_gels",
                                      "eu_fsf",
                                      "us_ofac_sdn"
                                    ],
                                    "type": "string",
                                    "description": "`fr_tresor_gels` : le registre national des gels des avoirs (tenu par la DG Trésor, l'administration du Trésor), contraignant ; `eu_fsf` : la liste consolidée des sanctions financières de l'UE, contraignante ; `us_ofac_sdn` : la liste OFAC SDN des États-Unis, simple information sur un risque de sanctions américaines, sans effet juridique en France."
                                  },
                                  "binding": {
                                    "type": "boolean",
                                    "description": "Une liste de gel contraignante en France (`fr_tresor_gels`, `eu_fsf`) ; false pour OFAC."
                                  },
                                  "published_at": {
                                    "type": "string",
                                    "format": "date-time",
                                    "description": "La date de publication que la liste indique elle-même."
                                  },
                                  "publisher": {
                                    "type": "string",
                                    "description": "Qui publie la liste : la DG Trésor, la Commission européenne, l'OFAC du Trésor américain."
                                  },
                                  "licence": {
                                    "type": "string",
                                    "description": "Les conditions de réutilisation de la liste : Licence Ouverte / Open Licence 2.0 (Etalab) pour le registre français, décision 2011/833/UE de la Commission pour la liste de l'UE, domaine public (œuvre du gouvernement américain) pour OFAC."
                                  },
                                  "licence_url": {
                                    "type": "string",
                                    "description": "Le texte de ces conditions de réutilisation."
                                  },
                                  "attribution": {
                                    "type": "string",
                                    "description": "La mention de la source à afficher à côté d'un résultat fondé sur la liste (son éditeur, sa licence et sa date de publication), dans la langue de la requête : les conditions de réutilisation du registre français et de la liste de l'UE l'exigent."
                                  }
                                },
                                "required": [
                                  "source",
                                  "binding",
                                  "published_at",
                                  "publisher",
                                  "licence",
                                  "licence_url",
                                  "attribution"
                                ]
                              },
                              "description": "Les listes consultées et la publication de chacune, vide si aucune recherche n'a eu lieu : un résultat ne vaut que pour ces versions."
                            },
                            "matches": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "source": {
                                    "enum": [
                                      "fr_tresor_gels",
                                      "eu_fsf",
                                      "us_ofac_sdn"
                                    ],
                                    "type": "string",
                                    "description": "`fr_tresor_gels` : le registre national des gels des avoirs (tenu par la DG Trésor, l'administration du Trésor), contraignant ; `eu_fsf` : la liste consolidée des sanctions financières de l'UE, contraignante ; `us_ofac_sdn` : la liste OFAC SDN des États-Unis, simple information sur un risque de sanctions américaines, sans effet juridique en France."
                                  },
                                  "binding": {
                                    "type": "boolean",
                                    "description": "Une correspondance sur une liste de gel contraignante : vérifiez l'identité et, s'il s'agit de la personne désignée, gelez et déclarez sans délai à la DG Trésor. False pour OFAC : un risque de sanctions américaines à évaluer."
                                  },
                                  "listed_name": {
                                    "type": "string",
                                    "description": "Le nom tel que la liste l'écrit."
                                  },
                                  "matched_name": {
                                    "anyOf": [
                                      {
                                        "type": "string"
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "Le nom ou l'alias inscrit auquel l'identité du client correspond."
                                  },
                                  "score": {
                                    "type": "number",
                                    "minimum": 0,
                                    "maximum": 1,
                                    "description": "À quel point le nom inscrit est proche de celui du client, de 0 à 1 (1 : le même nom). Les noms sont comparés avec souplesse, pour retrouver les variantes d'orthographe."
                                  },
                                  "birth_dates": {
                                    "type": "array",
                                    "items": {
                                      "type": "string"
                                    },
                                    "description": "`YYYY`, `YYYY-MM` ou `YYYY-MM-DD`. Une date approximative de la liste (vers, une fourchette d'années) est étendue à chaque année qu'elle peut désigner."
                                  },
                                  "birth_dates_approximate": {
                                    "type": "boolean",
                                    "description": "La liste indique une date de naissance approximative (vers, une fourchette d'années, un autre calendrier) : la date de naissance du client ne fait jamais d'une telle correspondance un homonyme."
                                  },
                                  "nationalities": {
                                    "type": "array",
                                    "items": {
                                      "type": "string"
                                    },
                                    "description": "Codes ISO 3166-1 alpha-2."
                                  },
                                  "regime": {
                                    "anyOf": [
                                      {
                                        "type": "string"
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "Régime ou programme de sanctions."
                                  },
                                  "legal_basis": {
                                    "anyOf": [
                                      {
                                        "type": "string"
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "L'acte sur lequel repose l'inscription."
                                  },
                                  "official_reference": {
                                    "anyOf": [
                                      {
                                        "type": "string"
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "La référence de l'inscription dans sa liste."
                                  },
                                  "listed_at": {
                                    "anyOf": [
                                      {
                                        "type": "string"
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "Date de première inscription (`YYYY-MM-DD`) quand la liste l'indique."
                                  },
                                  "source_url": {
                                    "anyOf": [
                                      {
                                        "type": "string"
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "La page officielle de l'inscription ou de son acte juridique."
                                  },
                                  "homonym": {
                                    "type": "boolean",
                                    "description": "Un homonyme probable : la date de naissance du client contredit toutes les dates de naissance exactes de l'inscription. Affiché, jamais compté dans `outcome`."
                                  }
                                },
                                "required": [
                                  "source",
                                  "binding",
                                  "listed_name",
                                  "matched_name",
                                  "score",
                                  "birth_dates",
                                  "birth_dates_approximate",
                                  "nationalities",
                                  "regime",
                                  "legal_basis",
                                  "official_reference",
                                  "listed_at",
                                  "source_url",
                                  "homonym"
                                ]
                              },
                              "description": "Les listes contraignantes d'abord, puis par score."
                            }
                          },
                          "required": [
                            "id",
                            "status",
                            "outcome",
                            "trigger",
                            "requested_at",
                            "screened_at",
                            "checked_at",
                            "error_code",
                            "lists",
                            "matches"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Le résultat actuel : la dernière recherche terminée, qu'une demande plus récente en attente ou sans réponse ne masque jamais. Null tant que le client n'en a pas."
                    },
                    "latest": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "description": "L'identifiant de cette demande."
                        },
                        "status": {
                          "enum": [
                            "pending",
                            "completed",
                            "failed",
                            "unavailable"
                          ],
                          "type": "string",
                          "description": "`pending` : en attente ; `completed` : les listes ont été consultées (`outcome`) ; `failed` : l'identité n'a pas pu être recherchée (`error_code`) ; `unavailable` : les listes n'ont pas pu être consultées pour l'instant, LexOpti réessaie plus tard."
                        },
                        "outcome": {
                          "anyOf": [
                            {
                              "enum": [
                                "no_match",
                                "possible_match"
                              ],
                              "type": "string",
                              "description": "`no_match` : aucune correspondance dans les listes consultées, aux versions indiquées (jamais une attestation que le client est conforme ou non gelé) ; `possible_match` : au moins une personne ou entité inscrite peut être le client, à vérifier."
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Renseigné quand `status` vaut `completed`, null sinon."
                        },
                        "trigger": {
                          "enum": [
                            "initial",
                            "identity_change",
                            "requested",
                            "list_update"
                          ],
                          "type": "string",
                          "description": "`initial` : votre application a créé le client par l'API ; `identity_change` : votre application a modifié un champ d'identité analysé d'un tel client ; `requested` : votre application a demandé l'analyse (`POST /v1/clients/{id}/preliminary-screening`) ; `list_update` : une nouvelle publication des listes a changé le résultat."
                        },
                        "requested_at": {
                          "type": "string",
                          "format": "date-time",
                          "description": "Quand l'analyse a été demandée."
                        },
                        "screened_at": {
                          "anyOf": [
                            {
                              "type": "string",
                              "format": "date-time"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Quand la recherche a eu lieu ; null si aucune n'a eu lieu (`pending`, `unavailable`, ou une identité qui n'a pas pu être recherchée)."
                        },
                        "checked_at": {
                          "anyOf": [
                            {
                              "type": "string",
                              "format": "date-time"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Dernière fois que ce résultat a été confirmé sur une publication des listes ; null sauf si `completed`."
                        },
                        "error_code": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Pourquoi elle est `failed` ou `unavailable` : `unscreenable_subject` (aucun nom ni identifiant à rechercher), `saturated` (trop de candidats pour déclarer le client sans correspondance), `lists_not_indexed` (les listes ne sont pas encore consultables), `yente_unavailable` (le service de recherche n'a pas répondu), `screening_timeout` (la recherche n'a pas pu avoir lieu à temps), `sandbox_error` (le `ERREUR` du bac à sable). D'autres codes peuvent s'ajouter."
                        },
                        "lists": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "source": {
                                "enum": [
                                  "fr_tresor_gels",
                                  "eu_fsf",
                                  "us_ofac_sdn"
                                ],
                                "type": "string",
                                "description": "`fr_tresor_gels` : le registre national des gels des avoirs (tenu par la DG Trésor, l'administration du Trésor), contraignant ; `eu_fsf` : la liste consolidée des sanctions financières de l'UE, contraignante ; `us_ofac_sdn` : la liste OFAC SDN des États-Unis, simple information sur un risque de sanctions américaines, sans effet juridique en France."
                              },
                              "binding": {
                                "type": "boolean",
                                "description": "Une liste de gel contraignante en France (`fr_tresor_gels`, `eu_fsf`) ; false pour OFAC."
                              },
                              "published_at": {
                                "type": "string",
                                "format": "date-time",
                                "description": "La date de publication que la liste indique elle-même."
                              },
                              "publisher": {
                                "type": "string",
                                "description": "Qui publie la liste : la DG Trésor, la Commission européenne, l'OFAC du Trésor américain."
                              },
                              "licence": {
                                "type": "string",
                                "description": "Les conditions de réutilisation de la liste : Licence Ouverte / Open Licence 2.0 (Etalab) pour le registre français, décision 2011/833/UE de la Commission pour la liste de l'UE, domaine public (œuvre du gouvernement américain) pour OFAC."
                              },
                              "licence_url": {
                                "type": "string",
                                "description": "Le texte de ces conditions de réutilisation."
                              },
                              "attribution": {
                                "type": "string",
                                "description": "La mention de la source à afficher à côté d'un résultat fondé sur la liste (son éditeur, sa licence et sa date de publication), dans la langue de la requête : les conditions de réutilisation du registre français et de la liste de l'UE l'exigent."
                              }
                            },
                            "required": [
                              "source",
                              "binding",
                              "published_at",
                              "publisher",
                              "licence",
                              "licence_url",
                              "attribution"
                            ]
                          },
                          "description": "Les listes consultées et la publication de chacune, vide si aucune recherche n'a eu lieu : un résultat ne vaut que pour ces versions."
                        },
                        "matches": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "source": {
                                "enum": [
                                  "fr_tresor_gels",
                                  "eu_fsf",
                                  "us_ofac_sdn"
                                ],
                                "type": "string",
                                "description": "`fr_tresor_gels` : le registre national des gels des avoirs (tenu par la DG Trésor, l'administration du Trésor), contraignant ; `eu_fsf` : la liste consolidée des sanctions financières de l'UE, contraignante ; `us_ofac_sdn` : la liste OFAC SDN des États-Unis, simple information sur un risque de sanctions américaines, sans effet juridique en France."
                              },
                              "binding": {
                                "type": "boolean",
                                "description": "Une correspondance sur une liste de gel contraignante : vérifiez l'identité et, s'il s'agit de la personne désignée, gelez et déclarez sans délai à la DG Trésor. False pour OFAC : un risque de sanctions américaines à évaluer."
                              },
                              "listed_name": {
                                "type": "string",
                                "description": "Le nom tel que la liste l'écrit."
                              },
                              "matched_name": {
                                "anyOf": [
                                  {
                                    "type": "string"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "Le nom ou l'alias inscrit auquel l'identité du client correspond."
                              },
                              "score": {
                                "type": "number",
                                "minimum": 0,
                                "maximum": 1,
                                "description": "À quel point le nom inscrit est proche de celui du client, de 0 à 1 (1 : le même nom). Les noms sont comparés avec souplesse, pour retrouver les variantes d'orthographe."
                              },
                              "birth_dates": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                },
                                "description": "`YYYY`, `YYYY-MM` ou `YYYY-MM-DD`. Une date approximative de la liste (vers, une fourchette d'années) est étendue à chaque année qu'elle peut désigner."
                              },
                              "birth_dates_approximate": {
                                "type": "boolean",
                                "description": "La liste indique une date de naissance approximative (vers, une fourchette d'années, un autre calendrier) : la date de naissance du client ne fait jamais d'une telle correspondance un homonyme."
                              },
                              "nationalities": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                },
                                "description": "Codes ISO 3166-1 alpha-2."
                              },
                              "regime": {
                                "anyOf": [
                                  {
                                    "type": "string"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "Régime ou programme de sanctions."
                              },
                              "legal_basis": {
                                "anyOf": [
                                  {
                                    "type": "string"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "L'acte sur lequel repose l'inscription."
                              },
                              "official_reference": {
                                "anyOf": [
                                  {
                                    "type": "string"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "La référence de l'inscription dans sa liste."
                              },
                              "listed_at": {
                                "anyOf": [
                                  {
                                    "type": "string"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "Date de première inscription (`YYYY-MM-DD`) quand la liste l'indique."
                              },
                              "source_url": {
                                "anyOf": [
                                  {
                                    "type": "string"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "La page officielle de l'inscription ou de son acte juridique."
                              },
                              "homonym": {
                                "type": "boolean",
                                "description": "Un homonyme probable : la date de naissance du client contredit toutes les dates de naissance exactes de l'inscription. Affiché, jamais compté dans `outcome`."
                              }
                            },
                            "required": [
                              "source",
                              "binding",
                              "listed_name",
                              "matched_name",
                              "score",
                              "birth_dates",
                              "birth_dates_approximate",
                              "nationalities",
                              "regime",
                              "legal_basis",
                              "official_reference",
                              "listed_at",
                              "source_url",
                              "homonym"
                            ]
                          },
                          "description": "Les listes contraignantes d'abord, puis par score."
                        }
                      },
                      "required": [
                        "id",
                        "status",
                        "outcome",
                        "trigger",
                        "requested_at",
                        "screened_at",
                        "checked_at",
                        "error_code",
                        "lists",
                        "matches"
                      ],
                      "description": "La dernière demande, quel que soit son statut ; la même que `current` une fois terminée."
                    }
                  },
                  "required": [
                    "client_id",
                    "current",
                    "latest"
                  ],
                  "description": "L'analyse préliminaire gratuite du client sur les listes officielles de gels et de sanctions. Elle ne couvre que les gels et les sanctions, avec une correspondance approximative, jamais toute la vigilance : ouvrez un dossier et lancez une analyse pour l'analyse complète."
                }
              }
            },
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              },
              "RateLimit": {
                "description": "Requêtes restantes et secondes avant la réinitialisation de la fenêtre.",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Policy": {
                "description": "Requêtes autorisées par fenêtre, par application.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Requête invalide : `validation_failed` liste les champs invalides.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Jeton absent, invalide ou expiré, ou accès du membre à l'application terminé (`invalid_token`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Portée manquante (`insufficient_scope`), membre en lecture seule (`readonly_member`), ou action que l'abonnement de l'organisation refuse.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Introuvable dans l'organisation à laquelle le jeton est lié (`not_found`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Conflit : une requête avec la même `Idempotency-Key` est encore en cours.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Cette `Idempotency-Key` a servi à une autre requête.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Limite de débit atteinte (`rate_limited`) ; réessayez après `Retry-After` secondes.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Erreur inattendue (`internal_error`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          }
        },
        "security": [
          {
            "oauth2": [
              "lexopti:read"
            ]
          }
        ],
        "x-codeSamples": [
          {
            "lang": "typescript",
            "label": "TypeScript",
            "source": "import { createLexOptiClient } from \"@lexopti/sdk\";\n\nconst lexopti = createLexOptiClient({ accessToken: () => process.env.LEXOPTI_TOKEN ?? \"\" });\n\nconst screening = await lexopti.clients.getPreliminaryScreening({\n\tid: \"6f1b8d6e-2c4a-4f5e-9b1d-3a7c2e8f4d10\",\n});\n// A newer request may still be running: the current result stays shown.\nconsole.log(screening.latest.status);\nconst result = screening.current;\nif (result) {\n\tfor (const list of result.lists) {\n\t\t// The source statement the lists' reuse terms ask you to show.\n\t\tconsole.log(list.attribution);\n\t}\n\tif (result.outcome === \"possible_match\") {\n\t\tfor (const match of result.matches.filter((m) => !m.homonym)) {\n\t\t\tconsole.log(match.source, match.listed_name, match.source_url);\n\t\t}\n\t}\n}"
          },
          {
            "lang": "curl",
            "label": "curl",
            "source": "curl -X GET \"https://app.lexopti.com/v1/clients/:id/preliminary-screening\" \\\n  -H \"Authorization: Bearer $LEXOPTI_TOKEN\""
          },
          {
            "lang": "php",
            "label": "PHP",
            "source": "$response = (new GuzzleHttp\\Client())->request('GET', 'https://app.lexopti.com/v1/clients/:id/preliminary-screening', [\n    'headers' => ['Authorization' => 'Bearer ' . getenv('LEXOPTI_TOKEN')],\n]);"
          }
        ]
      },
      "post": {
        "operationId": "clients.requestPreliminaryScreening",
        "summary": "Demander l'analyse préliminaire du client",
        "description": "Demande l'analyse préliminaire gratuite de tout client que votre jeton atteint, quel qu'en soit le créateur (un client créé dans LexOpti et lié à votre référence compris) : une recherche des listes officielles de gels et de sanctions, gratuite, jamais une analyse complète. Sans corps. LexOpti analyse de lui-même un client que votre application crée par l'API ; cette opération sert aux autres, et à un client dont l'identité a changé hors de votre application. Asynchrone : la réponse est l'analyse du client avec sa nouvelle demande `pending` (`trigger: requested`) et son résultat actuel, conservé jusqu'à ce que la nouvelle se termine ; suivez `client.preliminary_screening_completed` ou lisez `GET /v1/clients/{id}/preliminary-screening`. Un bac à sable répond aussitôt. Une demande encore en cours répond 409 `preliminary_screening_pending` ; un déploiement sans la fonctionnalité ou sans ses listes, 503 `preliminary_screening_unavailable`. Exige une `Idempotency-Key` ; une nouvelle tentative avec elle répond la première demande.",
        "tags": [
          "Clients"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "L'identifiant LexOpti, tel que la création ou une liste l'a renvoyé (retrouvez un client ou un dossier par votre propre référence avec `?external_ref=`)."
            },
            "description": "L'identifiant LexOpti, tel que la création ou une liste l'a renvoyé (retrouvez un client ou un dossier par votre propre référence avec `?external_ref=`)."
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Clé unique de cette requête (un UUID) : une nouvelle tentative avec la même clé et le même corps reçoit la première réponse.",
            "schema": {
              "type": "string",
              "maxLength": 255
            }
          }
        ],
        "responses": {
          "202": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "client_id": {
                      "type": "string",
                      "description": "Le client analysé."
                    },
                    "current": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "description": "L'identifiant de cette demande."
                            },
                            "status": {
                              "enum": [
                                "pending",
                                "completed",
                                "failed",
                                "unavailable"
                              ],
                              "type": "string",
                              "description": "`pending` : en attente ; `completed` : les listes ont été consultées (`outcome`) ; `failed` : l'identité n'a pas pu être recherchée (`error_code`) ; `unavailable` : les listes n'ont pas pu être consultées pour l'instant, LexOpti réessaie plus tard."
                            },
                            "outcome": {
                              "anyOf": [
                                {
                                  "enum": [
                                    "no_match",
                                    "possible_match"
                                  ],
                                  "type": "string",
                                  "description": "`no_match` : aucune correspondance dans les listes consultées, aux versions indiquées (jamais une attestation que le client est conforme ou non gelé) ; `possible_match` : au moins une personne ou entité inscrite peut être le client, à vérifier."
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Renseigné quand `status` vaut `completed`, null sinon."
                            },
                            "trigger": {
                              "enum": [
                                "initial",
                                "identity_change",
                                "requested",
                                "list_update"
                              ],
                              "type": "string",
                              "description": "`initial` : votre application a créé le client par l'API ; `identity_change` : votre application a modifié un champ d'identité analysé d'un tel client ; `requested` : votre application a demandé l'analyse (`POST /v1/clients/{id}/preliminary-screening`) ; `list_update` : une nouvelle publication des listes a changé le résultat."
                            },
                            "requested_at": {
                              "type": "string",
                              "format": "date-time",
                              "description": "Quand l'analyse a été demandée."
                            },
                            "screened_at": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "format": "date-time"
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Quand la recherche a eu lieu ; null si aucune n'a eu lieu (`pending`, `unavailable`, ou une identité qui n'a pas pu être recherchée)."
                            },
                            "checked_at": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "format": "date-time"
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Dernière fois que ce résultat a été confirmé sur une publication des listes ; null sauf si `completed`."
                            },
                            "error_code": {
                              "anyOf": [
                                {
                                  "type": "string"
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Pourquoi elle est `failed` ou `unavailable` : `unscreenable_subject` (aucun nom ni identifiant à rechercher), `saturated` (trop de candidats pour déclarer le client sans correspondance), `lists_not_indexed` (les listes ne sont pas encore consultables), `yente_unavailable` (le service de recherche n'a pas répondu), `screening_timeout` (la recherche n'a pas pu avoir lieu à temps), `sandbox_error` (le `ERREUR` du bac à sable). D'autres codes peuvent s'ajouter."
                            },
                            "lists": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "source": {
                                    "enum": [
                                      "fr_tresor_gels",
                                      "eu_fsf",
                                      "us_ofac_sdn"
                                    ],
                                    "type": "string",
                                    "description": "`fr_tresor_gels` : le registre national des gels des avoirs (tenu par la DG Trésor, l'administration du Trésor), contraignant ; `eu_fsf` : la liste consolidée des sanctions financières de l'UE, contraignante ; `us_ofac_sdn` : la liste OFAC SDN des États-Unis, simple information sur un risque de sanctions américaines, sans effet juridique en France."
                                  },
                                  "binding": {
                                    "type": "boolean",
                                    "description": "Une liste de gel contraignante en France (`fr_tresor_gels`, `eu_fsf`) ; false pour OFAC."
                                  },
                                  "published_at": {
                                    "type": "string",
                                    "format": "date-time",
                                    "description": "La date de publication que la liste indique elle-même."
                                  },
                                  "publisher": {
                                    "type": "string",
                                    "description": "Qui publie la liste : la DG Trésor, la Commission européenne, l'OFAC du Trésor américain."
                                  },
                                  "licence": {
                                    "type": "string",
                                    "description": "Les conditions de réutilisation de la liste : Licence Ouverte / Open Licence 2.0 (Etalab) pour le registre français, décision 2011/833/UE de la Commission pour la liste de l'UE, domaine public (œuvre du gouvernement américain) pour OFAC."
                                  },
                                  "licence_url": {
                                    "type": "string",
                                    "description": "Le texte de ces conditions de réutilisation."
                                  },
                                  "attribution": {
                                    "type": "string",
                                    "description": "La mention de la source à afficher à côté d'un résultat fondé sur la liste (son éditeur, sa licence et sa date de publication), dans la langue de la requête : les conditions de réutilisation du registre français et de la liste de l'UE l'exigent."
                                  }
                                },
                                "required": [
                                  "source",
                                  "binding",
                                  "published_at",
                                  "publisher",
                                  "licence",
                                  "licence_url",
                                  "attribution"
                                ]
                              },
                              "description": "Les listes consultées et la publication de chacune, vide si aucune recherche n'a eu lieu : un résultat ne vaut que pour ces versions."
                            },
                            "matches": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "source": {
                                    "enum": [
                                      "fr_tresor_gels",
                                      "eu_fsf",
                                      "us_ofac_sdn"
                                    ],
                                    "type": "string",
                                    "description": "`fr_tresor_gels` : le registre national des gels des avoirs (tenu par la DG Trésor, l'administration du Trésor), contraignant ; `eu_fsf` : la liste consolidée des sanctions financières de l'UE, contraignante ; `us_ofac_sdn` : la liste OFAC SDN des États-Unis, simple information sur un risque de sanctions américaines, sans effet juridique en France."
                                  },
                                  "binding": {
                                    "type": "boolean",
                                    "description": "Une correspondance sur une liste de gel contraignante : vérifiez l'identité et, s'il s'agit de la personne désignée, gelez et déclarez sans délai à la DG Trésor. False pour OFAC : un risque de sanctions américaines à évaluer."
                                  },
                                  "listed_name": {
                                    "type": "string",
                                    "description": "Le nom tel que la liste l'écrit."
                                  },
                                  "matched_name": {
                                    "anyOf": [
                                      {
                                        "type": "string"
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "Le nom ou l'alias inscrit auquel l'identité du client correspond."
                                  },
                                  "score": {
                                    "type": "number",
                                    "minimum": 0,
                                    "maximum": 1,
                                    "description": "À quel point le nom inscrit est proche de celui du client, de 0 à 1 (1 : le même nom). Les noms sont comparés avec souplesse, pour retrouver les variantes d'orthographe."
                                  },
                                  "birth_dates": {
                                    "type": "array",
                                    "items": {
                                      "type": "string"
                                    },
                                    "description": "`YYYY`, `YYYY-MM` ou `YYYY-MM-DD`. Une date approximative de la liste (vers, une fourchette d'années) est étendue à chaque année qu'elle peut désigner."
                                  },
                                  "birth_dates_approximate": {
                                    "type": "boolean",
                                    "description": "La liste indique une date de naissance approximative (vers, une fourchette d'années, un autre calendrier) : la date de naissance du client ne fait jamais d'une telle correspondance un homonyme."
                                  },
                                  "nationalities": {
                                    "type": "array",
                                    "items": {
                                      "type": "string"
                                    },
                                    "description": "Codes ISO 3166-1 alpha-2."
                                  },
                                  "regime": {
                                    "anyOf": [
                                      {
                                        "type": "string"
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "Régime ou programme de sanctions."
                                  },
                                  "legal_basis": {
                                    "anyOf": [
                                      {
                                        "type": "string"
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "L'acte sur lequel repose l'inscription."
                                  },
                                  "official_reference": {
                                    "anyOf": [
                                      {
                                        "type": "string"
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "La référence de l'inscription dans sa liste."
                                  },
                                  "listed_at": {
                                    "anyOf": [
                                      {
                                        "type": "string"
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "Date de première inscription (`YYYY-MM-DD`) quand la liste l'indique."
                                  },
                                  "source_url": {
                                    "anyOf": [
                                      {
                                        "type": "string"
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "La page officielle de l'inscription ou de son acte juridique."
                                  },
                                  "homonym": {
                                    "type": "boolean",
                                    "description": "Un homonyme probable : la date de naissance du client contredit toutes les dates de naissance exactes de l'inscription. Affiché, jamais compté dans `outcome`."
                                  }
                                },
                                "required": [
                                  "source",
                                  "binding",
                                  "listed_name",
                                  "matched_name",
                                  "score",
                                  "birth_dates",
                                  "birth_dates_approximate",
                                  "nationalities",
                                  "regime",
                                  "legal_basis",
                                  "official_reference",
                                  "listed_at",
                                  "source_url",
                                  "homonym"
                                ]
                              },
                              "description": "Les listes contraignantes d'abord, puis par score."
                            }
                          },
                          "required": [
                            "id",
                            "status",
                            "outcome",
                            "trigger",
                            "requested_at",
                            "screened_at",
                            "checked_at",
                            "error_code",
                            "lists",
                            "matches"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Le résultat actuel : la dernière recherche terminée, qu'une demande plus récente en attente ou sans réponse ne masque jamais. Null tant que le client n'en a pas."
                    },
                    "latest": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "description": "L'identifiant de cette demande."
                        },
                        "status": {
                          "enum": [
                            "pending",
                            "completed",
                            "failed",
                            "unavailable"
                          ],
                          "type": "string",
                          "description": "`pending` : en attente ; `completed` : les listes ont été consultées (`outcome`) ; `failed` : l'identité n'a pas pu être recherchée (`error_code`) ; `unavailable` : les listes n'ont pas pu être consultées pour l'instant, LexOpti réessaie plus tard."
                        },
                        "outcome": {
                          "anyOf": [
                            {
                              "enum": [
                                "no_match",
                                "possible_match"
                              ],
                              "type": "string",
                              "description": "`no_match` : aucune correspondance dans les listes consultées, aux versions indiquées (jamais une attestation que le client est conforme ou non gelé) ; `possible_match` : au moins une personne ou entité inscrite peut être le client, à vérifier."
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Renseigné quand `status` vaut `completed`, null sinon."
                        },
                        "trigger": {
                          "enum": [
                            "initial",
                            "identity_change",
                            "requested",
                            "list_update"
                          ],
                          "type": "string",
                          "description": "`initial` : votre application a créé le client par l'API ; `identity_change` : votre application a modifié un champ d'identité analysé d'un tel client ; `requested` : votre application a demandé l'analyse (`POST /v1/clients/{id}/preliminary-screening`) ; `list_update` : une nouvelle publication des listes a changé le résultat."
                        },
                        "requested_at": {
                          "type": "string",
                          "format": "date-time",
                          "description": "Quand l'analyse a été demandée."
                        },
                        "screened_at": {
                          "anyOf": [
                            {
                              "type": "string",
                              "format": "date-time"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Quand la recherche a eu lieu ; null si aucune n'a eu lieu (`pending`, `unavailable`, ou une identité qui n'a pas pu être recherchée)."
                        },
                        "checked_at": {
                          "anyOf": [
                            {
                              "type": "string",
                              "format": "date-time"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Dernière fois que ce résultat a été confirmé sur une publication des listes ; null sauf si `completed`."
                        },
                        "error_code": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Pourquoi elle est `failed` ou `unavailable` : `unscreenable_subject` (aucun nom ni identifiant à rechercher), `saturated` (trop de candidats pour déclarer le client sans correspondance), `lists_not_indexed` (les listes ne sont pas encore consultables), `yente_unavailable` (le service de recherche n'a pas répondu), `screening_timeout` (la recherche n'a pas pu avoir lieu à temps), `sandbox_error` (le `ERREUR` du bac à sable). D'autres codes peuvent s'ajouter."
                        },
                        "lists": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "source": {
                                "enum": [
                                  "fr_tresor_gels",
                                  "eu_fsf",
                                  "us_ofac_sdn"
                                ],
                                "type": "string",
                                "description": "`fr_tresor_gels` : le registre national des gels des avoirs (tenu par la DG Trésor, l'administration du Trésor), contraignant ; `eu_fsf` : la liste consolidée des sanctions financières de l'UE, contraignante ; `us_ofac_sdn` : la liste OFAC SDN des États-Unis, simple information sur un risque de sanctions américaines, sans effet juridique en France."
                              },
                              "binding": {
                                "type": "boolean",
                                "description": "Une liste de gel contraignante en France (`fr_tresor_gels`, `eu_fsf`) ; false pour OFAC."
                              },
                              "published_at": {
                                "type": "string",
                                "format": "date-time",
                                "description": "La date de publication que la liste indique elle-même."
                              },
                              "publisher": {
                                "type": "string",
                                "description": "Qui publie la liste : la DG Trésor, la Commission européenne, l'OFAC du Trésor américain."
                              },
                              "licence": {
                                "type": "string",
                                "description": "Les conditions de réutilisation de la liste : Licence Ouverte / Open Licence 2.0 (Etalab) pour le registre français, décision 2011/833/UE de la Commission pour la liste de l'UE, domaine public (œuvre du gouvernement américain) pour OFAC."
                              },
                              "licence_url": {
                                "type": "string",
                                "description": "Le texte de ces conditions de réutilisation."
                              },
                              "attribution": {
                                "type": "string",
                                "description": "La mention de la source à afficher à côté d'un résultat fondé sur la liste (son éditeur, sa licence et sa date de publication), dans la langue de la requête : les conditions de réutilisation du registre français et de la liste de l'UE l'exigent."
                              }
                            },
                            "required": [
                              "source",
                              "binding",
                              "published_at",
                              "publisher",
                              "licence",
                              "licence_url",
                              "attribution"
                            ]
                          },
                          "description": "Les listes consultées et la publication de chacune, vide si aucune recherche n'a eu lieu : un résultat ne vaut que pour ces versions."
                        },
                        "matches": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "source": {
                                "enum": [
                                  "fr_tresor_gels",
                                  "eu_fsf",
                                  "us_ofac_sdn"
                                ],
                                "type": "string",
                                "description": "`fr_tresor_gels` : le registre national des gels des avoirs (tenu par la DG Trésor, l'administration du Trésor), contraignant ; `eu_fsf` : la liste consolidée des sanctions financières de l'UE, contraignante ; `us_ofac_sdn` : la liste OFAC SDN des États-Unis, simple information sur un risque de sanctions américaines, sans effet juridique en France."
                              },
                              "binding": {
                                "type": "boolean",
                                "description": "Une correspondance sur une liste de gel contraignante : vérifiez l'identité et, s'il s'agit de la personne désignée, gelez et déclarez sans délai à la DG Trésor. False pour OFAC : un risque de sanctions américaines à évaluer."
                              },
                              "listed_name": {
                                "type": "string",
                                "description": "Le nom tel que la liste l'écrit."
                              },
                              "matched_name": {
                                "anyOf": [
                                  {
                                    "type": "string"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "Le nom ou l'alias inscrit auquel l'identité du client correspond."
                              },
                              "score": {
                                "type": "number",
                                "minimum": 0,
                                "maximum": 1,
                                "description": "À quel point le nom inscrit est proche de celui du client, de 0 à 1 (1 : le même nom). Les noms sont comparés avec souplesse, pour retrouver les variantes d'orthographe."
                              },
                              "birth_dates": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                },
                                "description": "`YYYY`, `YYYY-MM` ou `YYYY-MM-DD`. Une date approximative de la liste (vers, une fourchette d'années) est étendue à chaque année qu'elle peut désigner."
                              },
                              "birth_dates_approximate": {
                                "type": "boolean",
                                "description": "La liste indique une date de naissance approximative (vers, une fourchette d'années, un autre calendrier) : la date de naissance du client ne fait jamais d'une telle correspondance un homonyme."
                              },
                              "nationalities": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                },
                                "description": "Codes ISO 3166-1 alpha-2."
                              },
                              "regime": {
                                "anyOf": [
                                  {
                                    "type": "string"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "Régime ou programme de sanctions."
                              },
                              "legal_basis": {
                                "anyOf": [
                                  {
                                    "type": "string"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "L'acte sur lequel repose l'inscription."
                              },
                              "official_reference": {
                                "anyOf": [
                                  {
                                    "type": "string"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "La référence de l'inscription dans sa liste."
                              },
                              "listed_at": {
                                "anyOf": [
                                  {
                                    "type": "string"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "Date de première inscription (`YYYY-MM-DD`) quand la liste l'indique."
                              },
                              "source_url": {
                                "anyOf": [
                                  {
                                    "type": "string"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "La page officielle de l'inscription ou de son acte juridique."
                              },
                              "homonym": {
                                "type": "boolean",
                                "description": "Un homonyme probable : la date de naissance du client contredit toutes les dates de naissance exactes de l'inscription. Affiché, jamais compté dans `outcome`."
                              }
                            },
                            "required": [
                              "source",
                              "binding",
                              "listed_name",
                              "matched_name",
                              "score",
                              "birth_dates",
                              "birth_dates_approximate",
                              "nationalities",
                              "regime",
                              "legal_basis",
                              "official_reference",
                              "listed_at",
                              "source_url",
                              "homonym"
                            ]
                          },
                          "description": "Les listes contraignantes d'abord, puis par score."
                        }
                      },
                      "required": [
                        "id",
                        "status",
                        "outcome",
                        "trigger",
                        "requested_at",
                        "screened_at",
                        "checked_at",
                        "error_code",
                        "lists",
                        "matches"
                      ],
                      "description": "La dernière demande, quel que soit son statut ; la même que `current` une fois terminée."
                    }
                  },
                  "required": [
                    "client_id",
                    "current",
                    "latest"
                  ],
                  "description": "L'analyse préliminaire gratuite du client sur les listes officielles de gels et de sanctions. Elle ne couvre que les gels et les sanctions, avec une correspondance approximative, jamais toute la vigilance : ouvrez un dossier et lancez une analyse pour l'analyse complète."
                }
              }
            },
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              },
              "RateLimit": {
                "description": "Requêtes restantes et secondes avant la réinitialisation de la fenêtre.",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Policy": {
                "description": "Requêtes autorisées par fenêtre, par application.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Requête invalide : `validation_failed` liste les champs invalides.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Jeton absent, invalide ou expiré, ou accès du membre à l'application terminé (`invalid_token`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Portée manquante (`insufficient_scope`), membre en lecture seule (`readonly_member`), ou action que l'abonnement de l'organisation refuse.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Introuvable dans l'organisation à laquelle le jeton est lié (`not_found`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Conflit : une requête avec la même `Idempotency-Key` est encore en cours (`idempotency_request_in_progress`), ou une analyse préliminaire de ce client est déjà en cours (`preliminary_screening_pending`) : lisez son résultat une fois terminée, ou redemandez alors.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Cette `Idempotency-Key` a servi à une autre requête.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Limite de débit atteinte (`rate_limited`) ; réessayez après `Retry-After` secondes.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Erreur inattendue (`internal_error`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "L'analyse préliminaire n'est pas disponible sur ce déploiement, ou ses listes officielles ne sont pas encore chargées (`preliminary_screening_unavailable`) : rien n'a été demandé, réessayez plus tard.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          }
        },
        "security": [
          {
            "oauth2": [
              "lexopti:write"
            ]
          }
        ],
        "x-codeSamples": [
          {
            "lang": "typescript",
            "label": "TypeScript",
            "source": "import { createLexOptiClient } from \"@lexopti/sdk\";\n\nconst lexopti = createLexOptiClient({ accessToken: () => process.env.LEXOPTI_TOKEN ?? \"\" });\n\n// A client created in LexOpti and linked to your reference, or whose\n// identity changed outside your application: LexOpti screens the clients\n// you create through the API by itself.\nconst screening = await lexopti.clients.requestPreliminaryScreening({\n\tid: \"6f1b8d6e-2c4a-4f5e-9b1d-3a7c2e8f4d10\",\n});\n// The new request is pending; the previous result, if any, stays current\n// until it settles (client.preliminary_screening_completed).\nconsole.log(screening.latest.status, screening.latest.trigger);\nconsole.log(screening.current?.outcome ?? \"no result yet\");"
          },
          {
            "lang": "curl",
            "label": "curl",
            "source": "curl -X POST \"https://app.lexopti.com/v1/clients/:id/preliminary-screening\" \\\n  -H \"Authorization: Bearer $LEXOPTI_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Idempotency-Key: $(uuidgen)\" \\\n  -d '{}'"
          },
          {
            "lang": "php",
            "label": "PHP",
            "source": "$response = (new GuzzleHttp\\Client())->request('POST', 'https://app.lexopti.com/v1/clients/:id/preliminary-screening', [\n    'headers' => ['Authorization' => 'Bearer ' . getenv('LEXOPTI_TOKEN'), 'Idempotency-Key' => uniqid('', true)],\n    'json' => [],\n]);"
          }
        ]
      }
    },
    "/clients/{id}/external-ref": {
      "put": {
        "operationId": "clients.setExternalRef",
        "summary": "Définir la référence du client",
        "description": "Lie le client à votre propre identifiant, en remplaçant votre référence précédente ; la même référence une nouvelle fois ne change rien. Une référence qui désigne déjà un autre client répond 409 `external_ref_conflict`. Visible de votre seule application.",
        "tags": [
          "Clients"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "L'identifiant LexOpti, tel que la création ou une liste l'a renvoyé (retrouvez un client ou un dossier par votre propre référence avec `?external_ref=`)."
            },
            "description": "L'identifiant LexOpti, tel que la création ou une liste l'a renvoyé (retrouvez un client ou un dossier par votre propre référence avec `?external_ref=`)."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "external_ref": {
                    "type": "string",
                    "pattern": "^[A-Za-z0-9:._-]{1,255}$",
                    "description": "Votre propre identifiant de l'enregistrement, par exemple `crm:contact:1042` : 1 à 255 caractères parmi `A-Z a-z 0-9 : . _ -`, unique par application, organisation et type (client ou dossier). Un identifiant technique opaque, jamais une donnée personnelle (ni nom, ni date de naissance, ni e-mail…). Visible de votre seule application."
                  }
                },
                "required": [
                  "external_ref"
                ]
              },
              "examples": {
                "your_contact_s_id": {
                  "summary": "L'identifiant de votre contact",
                  "value": {
                    "external_ref": "crm:contact:1042"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Client"
                }
              }
            },
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              },
              "RateLimit": {
                "description": "Requêtes restantes et secondes avant la réinitialisation de la fenêtre.",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Policy": {
                "description": "Requêtes autorisées par fenêtre, par application.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Requête invalide : `validation_failed` liste les champs invalides.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Jeton absent, invalide ou expiré, ou accès du membre à l'application terminé (`invalid_token`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Portée manquante (`insufficient_scope`), membre en lecture seule (`readonly_member`), ou action que l'abonnement de l'organisation refuse.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Introuvable dans l'organisation à laquelle le jeton est lié (`not_found`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "L'`external_ref` désigne déjà un autre client de votre application (`external_ref_conflict`) : retrouvez-le avec `GET /v1/clients?external_ref=`.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Cette `Idempotency-Key` a servi à une autre requête.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Limite de débit atteinte (`rate_limited`) ; réessayez après `Retry-After` secondes.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Erreur inattendue (`internal_error`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          }
        },
        "security": [
          {
            "oauth2": [
              "lexopti:write"
            ]
          }
        ],
        "x-codeSamples": [
          {
            "lang": "typescript",
            "label": "TypeScript",
            "source": "import { createLexOptiClient } from \"@lexopti/sdk\";\n\nconst lexopti = createLexOptiClient({ accessToken: () => process.env.LEXOPTI_TOKEN ?? \"\" });\n\nconst client = await lexopti.clients.setExternalRef({\n\tid: \"6f1b8d6e-2c4a-4f5e-9b1d-3a7c2e8f4d10\",\n\texternal_ref: \"crm:contact:1042\",\n});\nconst page = await lexopti.clients.list({ external_ref: \"crm:contact:1042\" });\nconsole.log(client.external_ref, page.data[0]?.id);"
          },
          {
            "lang": "curl",
            "label": "curl",
            "source": "curl -X PUT \"https://app.lexopti.com/v1/clients/:id/external-ref\" \\\n  -H \"Authorization: Bearer $LEXOPTI_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Idempotency-Key: $(uuidgen)\" \\\n  -d '{\n    \"external_ref\": \"crm:contact:1042\"\n  }'"
          },
          {
            "lang": "php",
            "label": "PHP",
            "source": "$response = (new GuzzleHttp\\Client())->request('PUT', 'https://app.lexopti.com/v1/clients/:id/external-ref', [\n    'headers' => ['Authorization' => 'Bearer ' . getenv('LEXOPTI_TOKEN'), 'Idempotency-Key' => uniqid('', true)],\n    'json' => [\n        'external_ref' => 'crm:contact:1042',\n    ],\n]);"
          }
        ]
      },
      "delete": {
        "operationId": "clients.deleteExternalRef",
        "summary": "Retirer la référence du client",
        "description": "Délie le client de votre référence, qui peut alors désigner un autre client. Idempotent : un client sans référence répond de même. Les références des autres applications restent.",
        "tags": [
          "Clients"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "L'identifiant LexOpti, tel que la création ou une liste l'a renvoyé (retrouvez un client ou un dossier par votre propre référence avec `?external_ref=`)."
            },
            "description": "L'identifiant LexOpti, tel que la création ou une liste l'a renvoyé (retrouvez un client ou un dossier par votre propre référence avec `?external_ref=`)."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Client"
                }
              }
            },
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              },
              "RateLimit": {
                "description": "Requêtes restantes et secondes avant la réinitialisation de la fenêtre.",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Policy": {
                "description": "Requêtes autorisées par fenêtre, par application.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Requête invalide : `validation_failed` liste les champs invalides.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Jeton absent, invalide ou expiré, ou accès du membre à l'application terminé (`invalid_token`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Portée manquante (`insufficient_scope`), membre en lecture seule (`readonly_member`), ou action que l'abonnement de l'organisation refuse.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Introuvable dans l'organisation à laquelle le jeton est lié (`not_found`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Conflit : une requête avec la même `Idempotency-Key` est encore en cours.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Cette `Idempotency-Key` a servi à une autre requête.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Limite de débit atteinte (`rate_limited`) ; réessayez après `Retry-After` secondes.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Erreur inattendue (`internal_error`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          }
        },
        "security": [
          {
            "oauth2": [
              "lexopti:write"
            ]
          }
        ],
        "x-codeSamples": [
          {
            "lang": "typescript",
            "label": "TypeScript",
            "source": "import { createLexOptiClient } from \"@lexopti/sdk\";\n\nconst lexopti = createLexOptiClient({ accessToken: () => process.env.LEXOPTI_TOKEN ?? \"\" });\n\nconst client = await lexopti.clients.deleteExternalRef({\n\tid: \"6f1b8d6e-2c4a-4f5e-9b1d-3a7c2e8f4d10\",\n});\nconsole.log(client.external_ref);"
          },
          {
            "lang": "curl",
            "label": "curl",
            "source": "curl -X DELETE \"https://app.lexopti.com/v1/clients/:id/external-ref\" \\\n  -H \"Authorization: Bearer $LEXOPTI_TOKEN\""
          },
          {
            "lang": "php",
            "label": "PHP",
            "source": "$response = (new GuzzleHttp\\Client())->request('DELETE', 'https://app.lexopti.com/v1/clients/:id/external-ref', [\n    'headers' => ['Authorization' => 'Bearer ' . getenv('LEXOPTI_TOKEN')],\n]);"
          }
        ]
      }
    },
    "/organization": {
      "get": {
        "operationId": "organization.get",
        "summary": "Lire l'organisation courante",
        "description": "L'organisation à laquelle le jeton d'accès est lié et le membre pour lequel il agit. Utilisez-le pour tester une connexion.",
        "tags": [
          "Organization"
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "description": "Identifiant de l'organisation."
                    },
                    "name": {
                      "type": "string"
                    },
                    "sandbox": {
                      "type": "boolean",
                      "description": "Une organisation bac à sable : données fictives, aucune facturation, aucun effet extérieur."
                    },
                    "member": {
                      "type": "object",
                      "properties": {
                        "user_id": {
                          "type": "string"
                        },
                        "role": {
                          "type": "string",
                          "description": "Le rôle du membre : `owner`, `admin`, `member` ou `readonly`."
                        }
                      },
                      "required": [
                        "user_id",
                        "role"
                      ],
                      "description": "Le membre pour lequel le jeton agit."
                    },
                    "integration": {
                      "type": "object",
                      "properties": {
                        "client_id": {
                          "type": "string"
                        },
                        "delegated_mode": {
                          "type": "boolean",
                          "description": "Si l'organisation laisse votre application agir pour les membres qu'elle a enrôlés sans qu'ils se connectent, en nommant le membre qui agit avec `X-LexOpti-Acting-User` (actif par défaut pour une application installée ; LexOpti le désactive à la demande de la structure). Faux aussi quand votre application n'est pas installée pour toute l'organisation."
                        }
                      },
                      "required": [
                        "client_id",
                        "delegated_mode"
                      ],
                      "description": "Le client OAuth qui fait l'appel."
                    }
                  },
                  "required": [
                    "id",
                    "name",
                    "sandbox",
                    "member",
                    "integration"
                  ]
                }
              }
            },
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              },
              "RateLimit": {
                "description": "Requêtes restantes et secondes avant la réinitialisation de la fenêtre.",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Policy": {
                "description": "Requêtes autorisées par fenêtre, par application.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Requête invalide : `validation_failed` liste les champs invalides.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Jeton absent, invalide ou expiré, ou accès du membre à l'application terminé (`invalid_token`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Portée manquante (`insufficient_scope`), membre en lecture seule (`readonly_member`), ou action que l'abonnement de l'organisation refuse.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Introuvable dans l'organisation à laquelle le jeton est lié (`not_found`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Conflit : une requête avec la même `Idempotency-Key` est encore en cours.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Cette `Idempotency-Key` a servi à une autre requête.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Limite de débit atteinte (`rate_limited`) ; réessayez après `Retry-After` secondes.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Erreur inattendue (`internal_error`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          }
        },
        "security": [
          {
            "oauth2": [
              "lexopti:read"
            ]
          }
        ],
        "x-codeSamples": [
          {
            "lang": "typescript",
            "label": "TypeScript",
            "source": "import { createLexOptiClient } from \"@lexopti/sdk\";\n\nconst lexopti = createLexOptiClient({ accessToken: () => process.env.LEXOPTI_TOKEN ?? \"\" });\n\nconst organization = await lexopti.organization.get();\nconsole.log(\n\torganization.name,\n\torganization.sandbox,\n\torganization.member.role\n);"
          },
          {
            "lang": "curl",
            "label": "curl",
            "source": "curl -X GET \"https://app.lexopti.com/v1/organization\" \\\n  -H \"Authorization: Bearer $LEXOPTI_TOKEN\""
          },
          {
            "lang": "php",
            "label": "PHP",
            "source": "$response = (new GuzzleHttp\\Client())->request('GET', 'https://app.lexopti.com/v1/organization', [\n    'headers' => ['Authorization' => 'Bearer ' . getenv('LEXOPTI_TOKEN')],\n]);"
          }
        ]
      }
    },
    "/members": {
      "get": {
        "operationId": "members.list",
        "summary": "Lister les membres",
        "description": "Les membres de l'organisation, du plus récent au plus ancien : identifiant, nom, e-mail et rôle, rien d'autre. Seulement pour une application qu'un propriétaire ou un administrateur a installée pour toute l'organisation (403 `installation_required` sinon) : faites-y correspondre vos propres utilisateurs (les personnes qui utilisent votre logiciel) ; chaque membre se connecte toujours pour obtenir son propre jeton, avec ses propres droits.",
        "tags": [
          "Organization"
        ],
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 25,
              "description": "Taille de page, de 1 à 100."
            },
            "allowEmptyValue": true,
            "allowReserved": true,
            "description": "Taille de page, de 1 à 100."
          },
          {
            "name": "cursor",
            "in": "query",
            "schema": {
              "type": "string",
              "description": "`next_cursor` de la page précédente ; à omettre pour la première page."
            },
            "allowEmptyValue": true,
            "allowReserved": true,
            "description": "`next_cursor` de la page précédente ; à omettre pour la première page."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "description": "L'identifiant d'utilisateur du membre : le `member.user_id` que répond `GET /v1/organization` pour un jeton qui agit pour lui."
                          },
                          "name": {
                            "type": "string"
                          },
                          "email": {
                            "type": "string",
                            "description": "L'adresse avec laquelle le membre se connecte."
                          },
                          "role": {
                            "type": "string",
                            "description": "Le rôle du membre : `owner`, `admin`, `member` ou `readonly`."
                          }
                        },
                        "required": [
                          "id",
                          "name",
                          "email",
                          "role"
                        ]
                      }
                    },
                    "has_more": {
                      "type": "boolean"
                    },
                    "next_cursor": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "À passer en `cursor` pour lire la page suivante ; null sur la dernière."
                    }
                  },
                  "required": [
                    "data",
                    "has_more",
                    "next_cursor"
                  ]
                }
              }
            },
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              },
              "RateLimit": {
                "description": "Requêtes restantes et secondes avant la réinitialisation de la fenêtre.",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Policy": {
                "description": "Requêtes autorisées par fenêtre, par application.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Requête invalide : `validation_failed` liste les champs invalides.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Jeton absent, invalide ou expiré, ou accès du membre à l'application terminé (`invalid_token`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Portée manquante (`insufficient_scope`), ou votre application n'est pas installée pour toute l'organisation (`installation_required`) : un propriétaire ou un administrateur l'installe d'abord, depuis son consentement ou les applications connectées de LexOpti.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Introuvable dans l'organisation à laquelle le jeton est lié (`not_found`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Conflit : une requête avec la même `Idempotency-Key` est encore en cours.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Cette `Idempotency-Key` a servi à une autre requête.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Limite de débit atteinte (`rate_limited`) ; réessayez après `Retry-After` secondes.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Erreur inattendue (`internal_error`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          }
        },
        "security": [
          {
            "oauth2": [
              "lexopti:read"
            ]
          }
        ],
        "x-codeSamples": [
          {
            "lang": "typescript",
            "label": "TypeScript",
            "source": "import { createLexOptiClient } from \"@lexopti/sdk\";\n\nconst lexopti = createLexOptiClient({ accessToken: () => process.env.LEXOPTI_TOKEN ?? \"\" });\n\nconst memberIdByEmail = new Map<string, string>();\nlet cursor: string | undefined;\ndo {\n\tconst page = await lexopti.members.list({ limit: 100, cursor });\n\tfor (const member of page.data) {\n\t\tmemberIdByEmail.set(member.email.toLowerCase(), member.id);\n\t}\n\tcursor = page.next_cursor ?? undefined;\n} while (cursor !== undefined);\nconsole.log(memberIdByEmail.size, \"members\");"
          },
          {
            "lang": "curl",
            "label": "curl",
            "source": "curl -X GET \"https://app.lexopti.com/v1/members\" \\\n  -H \"Authorization: Bearer $LEXOPTI_TOKEN\""
          },
          {
            "lang": "php",
            "label": "PHP",
            "source": "$response = (new GuzzleHttp\\Client())->request('GET', 'https://app.lexopti.com/v1/members', [\n    'headers' => ['Authorization' => 'Bearer ' . getenv('LEXOPTI_TOKEN')],\n]);"
          }
        ]
      }
    },
    "/members/enrolments": {
      "post": {
        "operationId": "enrolments.create",
        "summary": "Enrôler un membre",
        "description": "Nomme une personne de la structure qui travaillera dans LexOpti par votre application, comme un propriétaire ou un administrateur de la structure le décide (le jeton doit être le sien : 403 `owner_or_admin_required` sinon), pour une application installée pour toute l'organisation (403 `installation_required`). LexOpti crée aussitôt son compte si l'adresse n'en a pas, décide son appartenance avec le rôle que vous donnez (`member` ou `readonly`, jamais plus), lui écrit que son accès est préparé, et active tout à son premier code e-mail : depuis votre logiciel, avec `lexopti_hint` portant son adresse, il saisit ce code et rien d'autre, puis revient avec son propre jeton. Une adresse déjà membre répond 409 `already_member` ; une adresse déjà enrôlée et en attente, 409 `enrolment_pending` ; une structure à sa limite de sièges, 402 `seat_limit_reached`. Envoie `member.enrolled`, puis `member.joined` à l'activation. Exige un `Idempotency-Key`.",
        "tags": [
          "Organization"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "email": {
                    "type": "string",
                    "maxLength": 254,
                    "format": "email",
                    "description": "L'adresse de la personne, celle avec laquelle elle se connectera : le code y est envoyé, et l'enrôlement s'active par elle."
                  },
                  "first_name": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 100,
                    "pattern": "^[^\\u0000-\\u001F\\u007F-\\u009F]*$",
                    "description": "Son prénom, pour le compte que LexOpti crée ; il pourra le changer."
                  },
                  "last_name": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 100,
                    "pattern": "^[^\\u0000-\\u001F\\u007F-\\u009F]*$",
                    "description": "Son nom, de même."
                  },
                  "role": {
                    "enum": [
                      "member",
                      "readonly"
                    ],
                    "type": "string",
                    "default": "member",
                    "description": "Son rôle dans la structure : `member` (travaille sur les clients et les dossiers) ou `readonly`. Les propriétaires et administrateurs sont nommés dans LexOpti, jamais par un partenaire."
                  },
                  "external_ref": {
                    "type": "string",
                    "pattern": "^[A-Za-z0-9:._-]{1,255}$",
                    "description": "Votre propre identifiant de la personne (par exemple `crm:user:42`) : 1 à 255 caractères parmi `A-Z a-z 0-9 : . _ -`. Un identifiant technique opaque, jamais une donnée personnelle. Visible par votre application seulement."
                  },
                  "locale": {
                    "enum": [
                      "fr",
                      "en"
                    ],
                    "type": "string",
                    "description": "La langue de l'e-mail qui le prévient ; `fr` par défaut."
                  }
                },
                "required": [
                  "email"
                ],
                "additionalProperties": false
              },
              "examples": {
                "a_member_of_the_organization": {
                  "summary": "Un membre de la structure",
                  "value": {
                    "email": "camille.durand@durand-conseil.fr",
                    "first_name": "Camille",
                    "last_name": "Durand",
                    "role": "member",
                    "external_ref": "crm:user:42"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "description": "L'identifiant de l'enrôlement (`enr_…`), pour `DELETE /v1/members/enrolments/{id}`."
                    },
                    "email": {
                      "type": "string",
                      "description": "L'adresse de la personne, telle que vous l'avez envoyée."
                    },
                    "first_name": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Son prénom, tel que vous l'avez envoyé ; null si vous n'en avez pas envoyé."
                    },
                    "last_name": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Son nom, tel que vous l'avez envoyé ; null si vous n'en avez pas envoyé."
                    },
                    "role": {
                      "enum": [
                        "member",
                        "readonly"
                      ],
                      "type": "string",
                      "description": "Son rôle dans la structure : `member` (travaille sur les clients et les dossiers) ou `readonly` (lecture seule)."
                    },
                    "external_ref": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Votre propre identifiant de la personne, tel que vous l'avez envoyé ; null si vous n'en avez pas envoyé."
                    },
                    "status": {
                      "enum": [
                        "pending",
                        "activated",
                        "expired",
                        "cancelled"
                      ],
                      "type": "string",
                      "description": "`pending` jusqu'au premier code e-mail de la personne ; `activated` une fois membre (`member_id` le nomme alors, l'`id` de `GET /v1/members`) ; `expired` trente jours après l'enrôlement sans code ; `cancelled` par votre application."
                    },
                    "member_id": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "L'identifiant d'utilisateur du membre une fois activé, null avant."
                    },
                    "enrolled_by": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "L'identifiant d'utilisateur du propriétaire ou de l'administrateur qui a demandé."
                    },
                    "created_at": {
                      "type": "string",
                      "format": "date-time",
                      "description": "Date de création (ISO 8601, UTC)."
                    },
                    "expires_at": {
                      "type": "string",
                      "format": "date-time",
                      "description": "Quand l'enrôlement expire si la personne n'a pas saisi son premier code : trente jours après sa création."
                    },
                    "activated_at": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "date-time"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Quand la personne a saisi son premier code et est devenue membre ; null avant."
                    },
                    "connect_hint": {
                      "type": "string",
                      "description": "La valeur `lexopti_hint` à placer sur le bouton « Connecter LexOpti » de cette personne : son adresse, pour que la connexion démarre avec. Des indications seulement ; le code fait le reste."
                    }
                  },
                  "required": [
                    "id",
                    "email",
                    "first_name",
                    "last_name",
                    "role",
                    "external_ref",
                    "status",
                    "member_id",
                    "enrolled_by",
                    "created_at",
                    "expires_at",
                    "activated_at",
                    "connect_hint"
                  ]
                }
              }
            },
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              },
              "RateLimit": {
                "description": "Requêtes restantes et secondes avant la réinitialisation de la fenêtre.",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Policy": {
                "description": "Requêtes autorisées par fenêtre, par application.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Requête invalide : `validation_failed` liste les champs invalides.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Jeton absent, invalide ou expiré, ou accès du membre à l'application terminé (`invalid_token`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Portée manquante (`insufficient_scope`), membre en lecture seule (`readonly_member`), ou action que l'abonnement de l'organisation refuse.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Introuvable dans l'organisation à laquelle le jeton est lié (`not_found`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Conflit : une requête avec la même `Idempotency-Key` est encore en cours.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Cette `Idempotency-Key` a servi à une autre requête.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Limite de débit atteinte (`rate_limited`) ; réessayez après `Retry-After` secondes.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Erreur inattendue (`internal_error`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          }
        },
        "security": [
          {
            "oauth2": [
              "lexopti:write"
            ]
          }
        ],
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Clé unique de cette requête (un UUID) : une nouvelle tentative avec la même clé et le même corps reçoit la première réponse.",
            "schema": {
              "type": "string",
              "maxLength": 255
            }
          }
        ],
        "x-codeSamples": [
          {
            "lang": "typescript",
            "label": "TypeScript",
            "source": "import { createLexOptiClient } from \"@lexopti/sdk\";\n\nconst lexopti = createLexOptiClient({ accessToken: () => process.env.LEXOPTI_TOKEN ?? \"\" });\n\nconst enrolment = await lexopti.enrolments.create({\n\temail: \"camille.durand@agence.example\",\n\tfirst_name: \"Camille\",\n\tlast_name: \"Durand\",\n\trole: \"member\",\n\texternal_ref: \"crm:user:42\",\n});\n// Put `connect_hint` in `lexopti_hint` on this agent's « Connecter LexOpti »\n// button: their address is prefilled, the code does the rest.\nconsole.log(enrolment.status, enrolment.connect_hint);"
          },
          {
            "lang": "curl",
            "label": "curl",
            "source": "curl -X POST \"https://app.lexopti.com/v1/members/enrolments\" \\\n  -H \"Authorization: Bearer $LEXOPTI_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Idempotency-Key: $(uuidgen)\" \\\n  -d '{\n    \"email\": \"camille.durand@durand-conseil.fr\",\n    \"first_name\": \"Camille\",\n    \"last_name\": \"Durand\",\n    \"role\": \"member\",\n    \"external_ref\": \"crm:user:42\"\n  }'"
          },
          {
            "lang": "php",
            "label": "PHP",
            "source": "$response = (new GuzzleHttp\\Client())->request('POST', 'https://app.lexopti.com/v1/members/enrolments', [\n    'headers' => ['Authorization' => 'Bearer ' . getenv('LEXOPTI_TOKEN'), 'Idempotency-Key' => uniqid('', true)],\n    'json' => [\n        'email' => 'camille.durand@durand-conseil.fr',\n        'first_name' => 'Camille',\n        'last_name' => 'Durand',\n        'role' => 'member',\n        'external_ref' => 'crm:user:42',\n    ],\n]);"
          }
        ]
      },
      "get": {
        "operationId": "enrolments.list",
        "summary": "Lister les enrôlements",
        "description": "Les personnes que votre application a enrôlées dans l'organisation, du plus récent au plus ancien, avec leur état : `pending` jusqu'à leur premier code, `activated` (avec l'identifiant du membre), `expired` après trente jours, `cancelled`. Seulement pour une application installée pour toute l'organisation.",
        "tags": [
          "Organization"
        ],
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 25,
              "description": "Taille de page, de 1 à 100."
            },
            "allowEmptyValue": true,
            "allowReserved": true,
            "description": "Taille de page, de 1 à 100."
          },
          {
            "name": "cursor",
            "in": "query",
            "schema": {
              "type": "string",
              "description": "`next_cursor` de la page précédente ; à omettre pour la première page."
            },
            "allowEmptyValue": true,
            "allowReserved": true,
            "description": "`next_cursor` de la page précédente ; à omettre pour la première page."
          },
          {
            "name": "status",
            "in": "query",
            "schema": {
              "enum": [
                "pending",
                "activated",
                "expired",
                "cancelled"
              ],
              "type": "string",
              "description": "Seulement les enrôlements dans cet état : `pending`, `activated`, `expired` ou `cancelled`. Absent : tous."
            },
            "allowEmptyValue": true,
            "allowReserved": true,
            "description": "Seulement les enrôlements dans cet état : `pending`, `activated`, `expired` ou `cancelled`. Absent : tous."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "description": "L'identifiant de l'enrôlement (`enr_…`), pour `DELETE /v1/members/enrolments/{id}`."
                          },
                          "email": {
                            "type": "string",
                            "description": "L'adresse de la personne, telle que vous l'avez envoyée."
                          },
                          "first_name": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Son prénom, tel que vous l'avez envoyé ; null si vous n'en avez pas envoyé."
                          },
                          "last_name": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Son nom, tel que vous l'avez envoyé ; null si vous n'en avez pas envoyé."
                          },
                          "role": {
                            "enum": [
                              "member",
                              "readonly"
                            ],
                            "type": "string",
                            "description": "Son rôle dans la structure : `member` (travaille sur les clients et les dossiers) ou `readonly` (lecture seule)."
                          },
                          "external_ref": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Votre propre identifiant de la personne, tel que vous l'avez envoyé ; null si vous n'en avez pas envoyé."
                          },
                          "status": {
                            "enum": [
                              "pending",
                              "activated",
                              "expired",
                              "cancelled"
                            ],
                            "type": "string",
                            "description": "`pending` jusqu'au premier code e-mail de la personne ; `activated` une fois membre (`member_id` le nomme alors, l'`id` de `GET /v1/members`) ; `expired` trente jours après l'enrôlement sans code ; `cancelled` par votre application."
                          },
                          "member_id": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "L'identifiant d'utilisateur du membre une fois activé, null avant."
                          },
                          "enrolled_by": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "L'identifiant d'utilisateur du propriétaire ou de l'administrateur qui a demandé."
                          },
                          "created_at": {
                            "type": "string",
                            "format": "date-time",
                            "description": "Date de création (ISO 8601, UTC)."
                          },
                          "expires_at": {
                            "type": "string",
                            "format": "date-time",
                            "description": "Quand l'enrôlement expire si la personne n'a pas saisi son premier code : trente jours après sa création."
                          },
                          "activated_at": {
                            "anyOf": [
                              {
                                "type": "string",
                                "format": "date-time"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Quand la personne a saisi son premier code et est devenue membre ; null avant."
                          },
                          "connect_hint": {
                            "type": "string",
                            "description": "La valeur `lexopti_hint` à placer sur le bouton « Connecter LexOpti » de cette personne : son adresse, pour que la connexion démarre avec. Des indications seulement ; le code fait le reste."
                          }
                        },
                        "required": [
                          "id",
                          "email",
                          "first_name",
                          "last_name",
                          "role",
                          "external_ref",
                          "status",
                          "member_id",
                          "enrolled_by",
                          "created_at",
                          "expires_at",
                          "activated_at",
                          "connect_hint"
                        ]
                      }
                    },
                    "has_more": {
                      "type": "boolean"
                    },
                    "next_cursor": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "À passer en `cursor` pour lire la page suivante ; null sur la dernière."
                    }
                  },
                  "required": [
                    "data",
                    "has_more",
                    "next_cursor"
                  ]
                }
              }
            },
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              },
              "RateLimit": {
                "description": "Requêtes restantes et secondes avant la réinitialisation de la fenêtre.",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Policy": {
                "description": "Requêtes autorisées par fenêtre, par application.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Requête invalide : `validation_failed` liste les champs invalides.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Jeton absent, invalide ou expiré, ou accès du membre à l'application terminé (`invalid_token`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Portée manquante (`insufficient_scope`), membre en lecture seule (`readonly_member`), ou action que l'abonnement de l'organisation refuse.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Introuvable dans l'organisation à laquelle le jeton est lié (`not_found`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Conflit : une requête avec la même `Idempotency-Key` est encore en cours.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Cette `Idempotency-Key` a servi à une autre requête.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Limite de débit atteinte (`rate_limited`) ; réessayez après `Retry-After` secondes.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Erreur inattendue (`internal_error`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          }
        },
        "security": [
          {
            "oauth2": [
              "lexopti:read"
            ]
          }
        ],
        "x-codeSamples": [
          {
            "lang": "typescript",
            "label": "TypeScript",
            "source": "import { createLexOptiClient } from \"@lexopti/sdk\";\n\nconst lexopti = createLexOptiClient({ accessToken: () => process.env.LEXOPTI_TOKEN ?? \"\" });\n\nconst waiting = await lexopti.enrolments.list({\n\tlimit: 100,\n\tstatus: \"pending\",\n});\nfor (const enrolment of waiting.data) {\n\tconsole.log(enrolment.email, \"has not signed in yet\");\n}"
          },
          {
            "lang": "curl",
            "label": "curl",
            "source": "curl -X GET \"https://app.lexopti.com/v1/members/enrolments\" \\\n  -H \"Authorization: Bearer $LEXOPTI_TOKEN\""
          },
          {
            "lang": "php",
            "label": "PHP",
            "source": "$response = (new GuzzleHttp\\Client())->request('GET', 'https://app.lexopti.com/v1/members/enrolments', [\n    'headers' => ['Authorization' => 'Bearer ' . getenv('LEXOPTI_TOKEN')],\n]);"
          }
        ]
      }
    },
    "/members/enrolments/{id}": {
      "delete": {
        "operationId": "enrolments.cancel",
        "summary": "Annuler un enrôlement",
        "description": "Annule un enrôlement qui attend encore le premier code de la personne : son appartenance ne sera pas créée. Un propriétaire ou un administrateur de la structure seulement. Un enrôlement activé ne s'annule pas : retirez le membre dans LexOpti.",
        "tags": [
          "Organization"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "L'identifiant de l'enrôlement (`enr_…`), tel que sa création ou `GET /v1/members/enrolments` l'a renvoyé."
            },
            "description": "L'identifiant de l'enrôlement (`enr_…`), tel que sa création ou `GET /v1/members/enrolments` l'a renvoyé."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "description": "L'identifiant de l'enrôlement (`enr_…`)."
                    },
                    "status": {
                      "const": "cancelled",
                      "description": "Toujours `cancelled`."
                    }
                  },
                  "required": [
                    "id",
                    "status"
                  ]
                }
              }
            },
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              },
              "RateLimit": {
                "description": "Requêtes restantes et secondes avant la réinitialisation de la fenêtre.",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Policy": {
                "description": "Requêtes autorisées par fenêtre, par application.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Requête invalide : `validation_failed` liste les champs invalides.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Jeton absent, invalide ou expiré, ou accès du membre à l'application terminé (`invalid_token`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Portée manquante (`insufficient_scope`), membre en lecture seule (`readonly_member`), ou action que l'abonnement de l'organisation refuse.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Introuvable dans l'organisation à laquelle le jeton est lié (`not_found`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Conflit : une requête avec la même `Idempotency-Key` est encore en cours.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Cette `Idempotency-Key` a servi à une autre requête.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Limite de débit atteinte (`rate_limited`) ; réessayez après `Retry-After` secondes.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Erreur inattendue (`internal_error`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          }
        },
        "security": [
          {
            "oauth2": [
              "lexopti:write"
            ]
          }
        ],
        "x-codeSamples": [
          {
            "lang": "typescript",
            "label": "TypeScript",
            "source": "import { createLexOptiClient } from \"@lexopti/sdk\";\n\nconst lexopti = createLexOptiClient({ accessToken: () => process.env.LEXOPTI_TOKEN ?? \"\" });\n\nconst cancelled = await lexopti.enrolments.cancel({\n\tid: \"enr_3fQm9zX1b2c4d5e6\",\n});\nconsole.log(cancelled.status);"
          },
          {
            "lang": "curl",
            "label": "curl",
            "source": "curl -X DELETE \"https://app.lexopti.com/v1/members/enrolments/:id\" \\\n  -H \"Authorization: Bearer $LEXOPTI_TOKEN\""
          },
          {
            "lang": "php",
            "label": "PHP",
            "source": "$response = (new GuzzleHttp\\Client())->request('DELETE', 'https://app.lexopti.com/v1/members/enrolments/:id', [\n    'headers' => ['Authorization' => 'Bearer ' . getenv('LEXOPTI_TOKEN')],\n]);"
          }
        ]
      }
    },
    "/webhook-endpoints": {
      "post": {
        "operationId": "webhookEndpoints.create",
        "summary": "Abonner un point de réception",
        "description": "Abonne une URL à des types d'événements de l'organisation, pour cette application. La réponse contient le secret de signature, une seule fois : une nouvelle tentative avec la même `Idempotency-Key` reçoit `idempotency_secret_withheld` (409) qui nomme le point de réception, dont vous renouvelez alors le secret. Exige une `Idempotency-Key`.",
        "tags": [
          "Webhooks"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "url": {
                    "type": "string",
                    "description": "URL HTTPS sur un nom d'hôte public, où LexOpti envoie les événements. Exemple : `https://crm.example.com/webhooks/lexopti`."
                  },
                  "event_types": {
                    "type": "array",
                    "minItems": 1,
                    "items": {
                      "x-extensible-enum": [
                        "check.completed",
                        "check.failed",
                        "client.created",
                        "client.updated",
                        "client.vigilance_level_changed",
                        "client.risk_level_changed",
                        "client.preliminary_screening_completed",
                        "classification.validated",
                        "case.created",
                        "case.updated",
                        "case.risk_level_changed",
                        "report.generated",
                        "alert.created",
                        "alert.resolved",
                        "decision.pending",
                        "quota.exhausted",
                        "subscription.inactive",
                        "access.revoked",
                        "member.enrolled",
                        "member.joined"
                      ],
                      "type": "string",
                      "description": "Un des types d'événement du catalogue (la section `webhooks` de ce document). De nouveaux types peuvent s'ajouter : ignorez ceux que vous ne traitez pas."
                    },
                    "description": "Les types d'événements à recevoir, au moins un (la section `webhooks` de ce document les liste). Exemple : `[\"check.completed\", \"alert.created\"]`."
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 200,
                    "description": "Votre libellé pour le point de réception, 200 caractères au plus. Exemple : `LexOpti sync`."
                  }
                },
                "required": [
                  "url",
                  "event_types"
                ]
              },
              "examples": {
                "checks_and_alerts": {
                  "summary": "Analyses et alertes",
                  "value": {
                    "url": "https://crm.example.com/webhooks/lexopti",
                    "event_types": [
                      "check.completed",
                      "check.failed",
                      "alert.created"
                    ],
                    "description": "Synchro LexOpti"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "description": "L'identifiant LexOpti du point de réception."
                    },
                    "url": {
                      "type": "string",
                      "format": "uri",
                      "description": "L'adresse où LexOpti envoie les événements."
                    },
                    "description": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Votre libellé pour le point de réception."
                    },
                    "event_types": {
                      "type": "array",
                      "items": {
                        "x-extensible-enum": [
                          "check.completed",
                          "check.failed",
                          "client.created",
                          "client.updated",
                          "client.vigilance_level_changed",
                          "client.risk_level_changed",
                          "client.preliminary_screening_completed",
                          "classification.validated",
                          "case.created",
                          "case.updated",
                          "case.risk_level_changed",
                          "report.generated",
                          "alert.created",
                          "alert.resolved",
                          "decision.pending",
                          "quota.exhausted",
                          "subscription.inactive",
                          "access.revoked",
                          "member.enrolled",
                          "member.joined"
                        ],
                        "type": "string",
                        "description": "Un des types d'événement du catalogue (la section `webhooks` de ce document). De nouveaux types peuvent s'ajouter : ignorez ceux que vous ne traitez pas."
                      },
                      "description": "Les types d'événements qu'il reçoit."
                    },
                    "status": {
                      "enum": [
                        "enabled",
                        "disabled"
                      ],
                      "type": "string",
                      "description": "`disabled` : LexOpti n'envoie rien ; `disabled_reason` dit pourquoi."
                    },
                    "disabled_reason": {
                      "anyOf": [
                        {
                          "x-extensible-enum": [
                            "failing",
                            "member",
                            "access_revoked"
                          ],
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "`failing` : tous les envois ont échoué pendant un cycle complet de reprises (environ trois jours) ; réactivez-le une fois corrigé. `member` : désactivé par `PATCH`. `access_revoked` : votre application a perdu son accès à l'organisation, ce qu'a dit un dernier envoi `access.revoked` ; réactivez-le une fois qu'un membre l'a de nouveau autorisée."
                    },
                    "created_at": {
                      "type": "string",
                      "format": "date-time",
                      "description": "Date de création (ISO 8601, UTC)."
                    },
                    "updated_at": {
                      "type": "string",
                      "format": "date-time",
                      "description": "Date de dernière modification (ISO 8601, UTC)."
                    },
                    "secret": {
                      "type": "string",
                      "description": "Secret de signature (`whsec_…`), affiché une seule fois : conservez-le pour vérifier l'en-tête `webhook-signature`."
                    }
                  },
                  "required": [
                    "id",
                    "url",
                    "description",
                    "event_types",
                    "status",
                    "disabled_reason",
                    "created_at",
                    "updated_at",
                    "secret"
                  ]
                }
              }
            },
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              },
              "RateLimit": {
                "description": "Requêtes restantes et secondes avant la réinitialisation de la fenêtre.",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Policy": {
                "description": "Requêtes autorisées par fenêtre, par application.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Requête invalide : `validation_failed` liste les champs invalides.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Jeton absent, invalide ou expiré, ou accès du membre à l'application terminé (`invalid_token`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Portée manquante (`insufficient_scope`), membre en lecture seule (`readonly_member`), ou action que l'abonnement de l'organisation refuse.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Introuvable dans l'organisation à laquelle le jeton est lié (`not_found`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Conflit : une requête avec la même `Idempotency-Key` est encore en cours.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Cette `Idempotency-Key` a servi à une autre requête.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Limite de débit atteinte (`rate_limited`) ; réessayez après `Retry-After` secondes.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Erreur inattendue (`internal_error`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          }
        },
        "security": [
          {
            "oauth2": [
              "lexopti:write"
            ]
          }
        ],
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Clé unique de cette requête (un UUID) : une nouvelle tentative avec la même clé et le même corps reçoit la première réponse.",
            "schema": {
              "type": "string",
              "maxLength": 255
            }
          }
        ],
        "x-codeSamples": [
          {
            "lang": "typescript",
            "label": "TypeScript",
            "source": "import { createLexOptiClient } from \"@lexopti/sdk\";\n\nconst lexopti = createLexOptiClient({ accessToken: () => process.env.LEXOPTI_TOKEN ?? \"\" });\n\n// Placeholder: your secret manager's client (Vault, AWS Secrets Manager…).\nconst secretManager = {\n\tsave: (_name: string, _secret: string) => Promise.resolve(),\n};\nconst endpoint = await lexopti.webhookEndpoints.create({\n\turl: \"https://crm.example.com/lexopti/webhooks\",\n\tevent_types: [\"check.completed\", \"alert.created\"],\n});\n// Answered once: keep it in your secret manager, never in a log.\nawait secretManager.save(\"lexopti-webhook-secret\", endpoint.secret);\nconsole.log(endpoint.id);"
          },
          {
            "lang": "curl",
            "label": "curl",
            "source": "curl -X POST \"https://app.lexopti.com/v1/webhook-endpoints\" \\\n  -H \"Authorization: Bearer $LEXOPTI_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Idempotency-Key: $(uuidgen)\" \\\n  -d '{\n    \"url\": \"https://crm.example.com/webhooks/lexopti\",\n    \"event_types\": [\n      \"check.completed\",\n      \"check.failed\",\n      \"alert.created\"\n    ],\n    \"description\": \"LexOpti sync\"\n  }'"
          },
          {
            "lang": "php",
            "label": "PHP",
            "source": "$response = (new GuzzleHttp\\Client())->request('POST', 'https://app.lexopti.com/v1/webhook-endpoints', [\n    'headers' => ['Authorization' => 'Bearer ' . getenv('LEXOPTI_TOKEN'), 'Idempotency-Key' => uniqid('', true)],\n    'json' => [\n        'url' => 'https://crm.example.com/webhooks/lexopti',\n        'event_types' => [\n            'check.completed',\n            'check.failed',\n            'alert.created',\n        ],\n        'description' => 'LexOpti sync',\n    ],\n]);"
          }
        ]
      },
      "get": {
        "operationId": "webhookEndpoints.list",
        "summary": "Lister les points de réception",
        "description": "Les points de réception de cette application dans l'organisation.",
        "tags": [
          "Webhooks"
        ],
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 25,
              "description": "Taille de page, de 1 à 100."
            },
            "allowEmptyValue": true,
            "allowReserved": true,
            "description": "Taille de page, de 1 à 100."
          },
          {
            "name": "cursor",
            "in": "query",
            "schema": {
              "type": "string",
              "description": "`next_cursor` de la page précédente ; à omettre pour la première page."
            },
            "allowEmptyValue": true,
            "allowReserved": true,
            "description": "`next_cursor` de la page précédente ; à omettre pour la première page."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/WebhookEndpoint"
                      }
                    },
                    "has_more": {
                      "type": "boolean"
                    },
                    "next_cursor": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "À passer en `cursor` pour lire la page suivante ; null sur la dernière."
                    }
                  },
                  "required": [
                    "data",
                    "has_more",
                    "next_cursor"
                  ]
                }
              }
            },
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              },
              "RateLimit": {
                "description": "Requêtes restantes et secondes avant la réinitialisation de la fenêtre.",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Policy": {
                "description": "Requêtes autorisées par fenêtre, par application.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Requête invalide : `validation_failed` liste les champs invalides.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Jeton absent, invalide ou expiré, ou accès du membre à l'application terminé (`invalid_token`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Portée manquante (`insufficient_scope`), membre en lecture seule (`readonly_member`), ou action que l'abonnement de l'organisation refuse.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Introuvable dans l'organisation à laquelle le jeton est lié (`not_found`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Conflit : une requête avec la même `Idempotency-Key` est encore en cours.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Cette `Idempotency-Key` a servi à une autre requête.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Limite de débit atteinte (`rate_limited`) ; réessayez après `Retry-After` secondes.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Erreur inattendue (`internal_error`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          }
        },
        "security": [
          {
            "oauth2": [
              "lexopti:read"
            ]
          }
        ],
        "x-codeSamples": [
          {
            "lang": "typescript",
            "label": "TypeScript",
            "source": "import { createLexOptiClient } from \"@lexopti/sdk\";\n\nconst lexopti = createLexOptiClient({ accessToken: () => process.env.LEXOPTI_TOKEN ?? \"\" });\n\nconst page = await lexopti.webhookEndpoints.list({});\nconsole.log(page.data.map((endpoint) => endpoint.url));"
          },
          {
            "lang": "curl",
            "label": "curl",
            "source": "curl -X GET \"https://app.lexopti.com/v1/webhook-endpoints\" \\\n  -H \"Authorization: Bearer $LEXOPTI_TOKEN\""
          },
          {
            "lang": "php",
            "label": "PHP",
            "source": "$response = (new GuzzleHttp\\Client())->request('GET', 'https://app.lexopti.com/v1/webhook-endpoints', [\n    'headers' => ['Authorization' => 'Bearer ' . getenv('LEXOPTI_TOKEN')],\n]);"
          }
        ]
      }
    },
    "/webhook-endpoints/{id}": {
      "get": {
        "operationId": "webhookEndpoints.get",
        "summary": "Lire un point de réception",
        "description": "Un point de réception de cette application dans l'organisation, sans son secret.",
        "tags": [
          "Webhooks"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "L'identifiant LexOpti, tel que la création ou une liste l'a renvoyé (retrouvez un client ou un dossier par votre propre référence avec `?external_ref=`)."
            },
            "description": "L'identifiant LexOpti, tel que la création ou une liste l'a renvoyé (retrouvez un client ou un dossier par votre propre référence avec `?external_ref=`)."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WebhookEndpoint"
                }
              }
            },
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              },
              "RateLimit": {
                "description": "Requêtes restantes et secondes avant la réinitialisation de la fenêtre.",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Policy": {
                "description": "Requêtes autorisées par fenêtre, par application.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Requête invalide : `validation_failed` liste les champs invalides.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Jeton absent, invalide ou expiré, ou accès du membre à l'application terminé (`invalid_token`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Portée manquante (`insufficient_scope`), membre en lecture seule (`readonly_member`), ou action que l'abonnement de l'organisation refuse.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Introuvable dans l'organisation à laquelle le jeton est lié (`not_found`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Conflit : une requête avec la même `Idempotency-Key` est encore en cours.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Cette `Idempotency-Key` a servi à une autre requête.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Limite de débit atteinte (`rate_limited`) ; réessayez après `Retry-After` secondes.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Erreur inattendue (`internal_error`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          }
        },
        "security": [
          {
            "oauth2": [
              "lexopti:read"
            ]
          }
        ],
        "x-codeSamples": [
          {
            "lang": "typescript",
            "label": "TypeScript",
            "source": "import { createLexOptiClient } from \"@lexopti/sdk\";\n\nconst lexopti = createLexOptiClient({ accessToken: () => process.env.LEXOPTI_TOKEN ?? \"\" });\n\nconst endpoint = await lexopti.webhookEndpoints.get({\n\tid: \"5e2a9c1d-7f3b-4a68-9d0e-2b1c4f6a8e3d\",\n});\nconsole.log(endpoint.status, endpoint.event_types);"
          },
          {
            "lang": "curl",
            "label": "curl",
            "source": "curl -X GET \"https://app.lexopti.com/v1/webhook-endpoints/:id\" \\\n  -H \"Authorization: Bearer $LEXOPTI_TOKEN\""
          },
          {
            "lang": "php",
            "label": "PHP",
            "source": "$response = (new GuzzleHttp\\Client())->request('GET', 'https://app.lexopti.com/v1/webhook-endpoints/:id', [\n    'headers' => ['Authorization' => 'Bearer ' . getenv('LEXOPTI_TOKEN')],\n]);"
          }
        ]
      },
      "patch": {
        "operationId": "webhookEndpoints.update",
        "summary": "Modifier un point de réception",
        "description": "Modifie l'URL, les types d'événements ou la description, ou active ou désactive le point de réception.",
        "tags": [
          "Webhooks"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "L'identifiant LexOpti, tel que la création ou une liste l'a renvoyé (retrouvez un client ou un dossier par votre propre référence avec `?external_ref=`)."
            },
            "description": "L'identifiant LexOpti, tel que la création ou une liste l'a renvoyé (retrouvez un client ou un dossier par votre propre référence avec `?external_ref=`)."
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "url": {
                    "type": "string",
                    "description": "URL HTTPS sur un nom d'hôte public, où LexOpti envoie les événements. Exemple : `https://crm.example.com/webhooks/lexopti`."
                  },
                  "event_types": {
                    "type": "array",
                    "minItems": 1,
                    "items": {
                      "x-extensible-enum": [
                        "check.completed",
                        "check.failed",
                        "client.created",
                        "client.updated",
                        "client.vigilance_level_changed",
                        "client.risk_level_changed",
                        "client.preliminary_screening_completed",
                        "classification.validated",
                        "case.created",
                        "case.updated",
                        "case.risk_level_changed",
                        "report.generated",
                        "alert.created",
                        "alert.resolved",
                        "decision.pending",
                        "quota.exhausted",
                        "subscription.inactive",
                        "access.revoked",
                        "member.enrolled",
                        "member.joined"
                      ],
                      "type": "string",
                      "description": "Un des types d'événement du catalogue (la section `webhooks` de ce document). De nouveaux types peuvent s'ajouter : ignorez ceux que vous ne traitez pas."
                    },
                    "description": "Les types d'événements à recevoir, au moins un (la section `webhooks` de ce document les liste). Exemple : `[\"check.completed\", \"alert.created\"]`. Remplace toute la liste."
                  },
                  "description": {
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 200
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Votre libellé pour le point de réception, 200 caractères au plus. Exemple : `LexOpti sync`. `null` l'efface."
                  },
                  "enabled": {
                    "type": "boolean",
                    "description": "`true` réactive un point de réception désactivé et remet à zéro sa série d'échecs."
                  }
                }
              },
              "examples": {
                "enable_again_checks_only": {
                  "summary": "Réactiver, analyses seulement",
                  "value": {
                    "event_types": [
                      "check.completed",
                      "check.failed"
                    ],
                    "enabled": true
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WebhookEndpoint"
                }
              }
            },
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              },
              "RateLimit": {
                "description": "Requêtes restantes et secondes avant la réinitialisation de la fenêtre.",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Policy": {
                "description": "Requêtes autorisées par fenêtre, par application.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Requête invalide : `validation_failed` liste les champs invalides.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Jeton absent, invalide ou expiré, ou accès du membre à l'application terminé (`invalid_token`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Portée manquante (`insufficient_scope`), membre en lecture seule (`readonly_member`), ou action que l'abonnement de l'organisation refuse.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Introuvable dans l'organisation à laquelle le jeton est lié (`not_found`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Conflit : une requête avec la même `Idempotency-Key` est encore en cours.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Cette `Idempotency-Key` a servi à une autre requête.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Limite de débit atteinte (`rate_limited`) ; réessayez après `Retry-After` secondes.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Erreur inattendue (`internal_error`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          }
        },
        "security": [
          {
            "oauth2": [
              "lexopti:write"
            ]
          }
        ],
        "x-codeSamples": [
          {
            "lang": "typescript",
            "label": "TypeScript",
            "source": "import { createLexOptiClient } from \"@lexopti/sdk\";\n\nconst lexopti = createLexOptiClient({ accessToken: () => process.env.LEXOPTI_TOKEN ?? \"\" });\n\nconst endpoint = await lexopti.webhookEndpoints.update({\n\tid: \"5e2a9c1d-7f3b-4a68-9d0e-2b1c4f6a8e3d\",\n\tevent_types: [\"check.completed\", \"check.failed\"],\n\tenabled: true,\n});\nconsole.log(endpoint.event_types);"
          },
          {
            "lang": "curl",
            "label": "curl",
            "source": "curl -X PATCH \"https://app.lexopti.com/v1/webhook-endpoints/:id\" \\\n  -H \"Authorization: Bearer $LEXOPTI_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Idempotency-Key: $(uuidgen)\" \\\n  -d '{\n    \"event_types\": [\n      \"check.completed\",\n      \"check.failed\"\n    ],\n    \"enabled\": true\n  }'"
          },
          {
            "lang": "php",
            "label": "PHP",
            "source": "$response = (new GuzzleHttp\\Client())->request('PATCH', 'https://app.lexopti.com/v1/webhook-endpoints/:id', [\n    'headers' => ['Authorization' => 'Bearer ' . getenv('LEXOPTI_TOKEN'), 'Idempotency-Key' => uniqid('', true)],\n    'json' => [\n        'event_types' => [\n            'check.completed',\n            'check.failed',\n        ],\n        'enabled' => true,\n    ],\n]);"
          }
        ]
      },
      "delete": {
        "operationId": "webhookEndpoints.delete",
        "summary": "Désabonner un point de réception",
        "description": "Supprime le point de réception et ses envois en attente. Idempotent : un point de réception déjà supprimé, ou inconnu de l'organisation, répond de même, une nouvelle tentative est donc sans risque.",
        "tags": [
          "Webhooks"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "L'identifiant LexOpti, tel que la création ou une liste l'a renvoyé (retrouvez un client ou un dossier par votre propre référence avec `?external_ref=`)."
            },
            "description": "L'identifiant LexOpti, tel que la création ou une liste l'a renvoyé (retrouvez un client ou un dossier par votre propre référence avec `?external_ref=`)."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "deleted": {
                      "const": true
                    }
                  },
                  "required": [
                    "id",
                    "deleted"
                  ]
                }
              }
            },
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              },
              "RateLimit": {
                "description": "Requêtes restantes et secondes avant la réinitialisation de la fenêtre.",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Policy": {
                "description": "Requêtes autorisées par fenêtre, par application.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Requête invalide : `validation_failed` liste les champs invalides.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Jeton absent, invalide ou expiré, ou accès du membre à l'application terminé (`invalid_token`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Portée manquante (`insufficient_scope`), membre en lecture seule (`readonly_member`), ou action que l'abonnement de l'organisation refuse.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Conflit : une requête avec la même `Idempotency-Key` est encore en cours.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Cette `Idempotency-Key` a servi à une autre requête.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Limite de débit atteinte (`rate_limited`) ; réessayez après `Retry-After` secondes.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Erreur inattendue (`internal_error`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          }
        },
        "security": [
          {
            "oauth2": [
              "lexopti:write"
            ]
          }
        ],
        "x-codeSamples": [
          {
            "lang": "typescript",
            "label": "TypeScript",
            "source": "import { createLexOptiClient } from \"@lexopti/sdk\";\n\nconst lexopti = createLexOptiClient({ accessToken: () => process.env.LEXOPTI_TOKEN ?? \"\" });\n\nconst deleted = await lexopti.webhookEndpoints.delete({\n\tid: \"5e2a9c1d-7f3b-4a68-9d0e-2b1c4f6a8e3d\",\n});\nconsole.log(deleted.deleted);"
          },
          {
            "lang": "curl",
            "label": "curl",
            "source": "curl -X DELETE \"https://app.lexopti.com/v1/webhook-endpoints/:id\" \\\n  -H \"Authorization: Bearer $LEXOPTI_TOKEN\""
          },
          {
            "lang": "php",
            "label": "PHP",
            "source": "$response = (new GuzzleHttp\\Client())->request('DELETE', 'https://app.lexopti.com/v1/webhook-endpoints/:id', [\n    'headers' => ['Authorization' => 'Bearer ' . getenv('LEXOPTI_TOKEN')],\n]);"
          }
        ]
      }
    },
    "/webhook-endpoints/{id}/rotate-secret": {
      "post": {
        "operationId": "webhookEndpoints.rotateSecret",
        "summary": "Renouveler le secret de signature",
        "description": "Un nouveau secret signe désormais chaque envoi ; les précédents signent encore pendant 24 heures, les envois portent donc plusieurs signatures entre-temps.",
        "tags": [
          "Webhooks"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "L'identifiant LexOpti, tel que la création ou une liste l'a renvoyé (retrouvez un client ou un dossier par votre propre référence avec `?external_ref=`)."
            },
            "description": "L'identifiant LexOpti, tel que la création ou une liste l'a renvoyé (retrouvez un client ou un dossier par votre propre référence avec `?external_ref=`)."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "secret": {
                      "type": "string",
                      "description": "Le nouveau secret de signature. Les précédents signent encore pendant 24 heures."
                    }
                  },
                  "required": [
                    "secret"
                  ]
                }
              }
            },
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              },
              "RateLimit": {
                "description": "Requêtes restantes et secondes avant la réinitialisation de la fenêtre.",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Policy": {
                "description": "Requêtes autorisées par fenêtre, par application.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Requête invalide : `validation_failed` liste les champs invalides.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Jeton absent, invalide ou expiré, ou accès du membre à l'application terminé (`invalid_token`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Portée manquante (`insufficient_scope`), membre en lecture seule (`readonly_member`), ou action que l'abonnement de l'organisation refuse.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Introuvable dans l'organisation à laquelle le jeton est lié (`not_found`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Conflit : une requête avec la même `Idempotency-Key` est encore en cours.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Cette `Idempotency-Key` a servi à une autre requête.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Limite de débit atteinte (`rate_limited`) ; réessayez après `Retry-After` secondes.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Erreur inattendue (`internal_error`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          }
        },
        "security": [
          {
            "oauth2": [
              "lexopti:write"
            ]
          }
        ],
        "x-codeSamples": [
          {
            "lang": "typescript",
            "label": "TypeScript",
            "source": "import { createLexOptiClient } from \"@lexopti/sdk\";\n\nconst lexopti = createLexOptiClient({ accessToken: () => process.env.LEXOPTI_TOKEN ?? \"\" });\n\n// Placeholder: your secret manager's client (Vault, AWS Secrets Manager…).\nconst secretManager = {\n\tsave: (_name: string, _secret: string) => Promise.resolve(),\n};\nconst { secret } = await lexopti.webhookEndpoints.rotateSecret({\n\tid: \"5e2a9c1d-7f3b-4a68-9d0e-2b1c4f6a8e3d\",\n});\n// Verify with both secrets until the old one expires, then drop it.\nawait secretManager.save(\"lexopti-webhook-secret\", secret);"
          },
          {
            "lang": "curl",
            "label": "curl",
            "source": "curl -X POST \"https://app.lexopti.com/v1/webhook-endpoints/:id/rotate-secret\" \\\n  -H \"Authorization: Bearer $LEXOPTI_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Idempotency-Key: $(uuidgen)\" \\\n  -d '{}'"
          },
          {
            "lang": "php",
            "label": "PHP",
            "source": "$response = (new GuzzleHttp\\Client())->request('POST', 'https://app.lexopti.com/v1/webhook-endpoints/:id/rotate-secret', [\n    'headers' => ['Authorization' => 'Bearer ' . getenv('LEXOPTI_TOKEN'), 'Idempotency-Key' => uniqid('', true)],\n    'json' => [],\n]);"
          }
        ]
      }
    },
    "/webhook-endpoints/{id}/test": {
      "post": {
        "operationId": "webhookEndpoints.test",
        "summary": "Envoyer un événement de test",
        "description": "Programme un envoi signé `webhook.test` vers le point de réception, repris comme les autres.",
        "tags": [
          "Webhooks"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "L'identifiant LexOpti, tel que la création ou une liste l'a renvoyé (retrouvez un client ou un dossier par votre propre référence avec `?external_ref=`)."
            },
            "description": "L'identifiant LexOpti, tel que la création ou une liste l'a renvoyé (retrouvez un client ou un dossier par votre propre référence avec `?external_ref=`)."
          }
        ],
        "responses": {
          "202": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WebhookDelivery"
                }
              }
            },
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              },
              "RateLimit": {
                "description": "Requêtes restantes et secondes avant la réinitialisation de la fenêtre.",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Policy": {
                "description": "Requêtes autorisées par fenêtre, par application.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Requête invalide : `validation_failed` liste les champs invalides.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Jeton absent, invalide ou expiré, ou accès du membre à l'application terminé (`invalid_token`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Portée manquante (`insufficient_scope`), membre en lecture seule (`readonly_member`), ou action que l'abonnement de l'organisation refuse.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Introuvable dans l'organisation à laquelle le jeton est lié (`not_found`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Conflit : une requête avec la même `Idempotency-Key` est encore en cours.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Cette `Idempotency-Key` a servi à une autre requête.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Limite de débit atteinte (`rate_limited`) ; réessayez après `Retry-After` secondes.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Erreur inattendue (`internal_error`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          }
        },
        "security": [
          {
            "oauth2": [
              "lexopti:write"
            ]
          }
        ],
        "x-codeSamples": [
          {
            "lang": "typescript",
            "label": "TypeScript",
            "source": "import { createLexOptiClient } from \"@lexopti/sdk\";\n\nconst lexopti = createLexOptiClient({ accessToken: () => process.env.LEXOPTI_TOKEN ?? \"\" });\n\nconst delivery = await lexopti.webhookEndpoints.test({\n\tid: \"5e2a9c1d-7f3b-4a68-9d0e-2b1c4f6a8e3d\",\n});\nconsole.log(delivery.type, delivery.status);"
          },
          {
            "lang": "curl",
            "label": "curl",
            "source": "curl -X POST \"https://app.lexopti.com/v1/webhook-endpoints/:id/test\" \\\n  -H \"Authorization: Bearer $LEXOPTI_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Idempotency-Key: $(uuidgen)\" \\\n  -d '{}'"
          },
          {
            "lang": "php",
            "label": "PHP",
            "source": "$response = (new GuzzleHttp\\Client())->request('POST', 'https://app.lexopti.com/v1/webhook-endpoints/:id/test', [\n    'headers' => ['Authorization' => 'Bearer ' . getenv('LEXOPTI_TOKEN'), 'Idempotency-Key' => uniqid('', true)],\n    'json' => [],\n]);"
          }
        ]
      }
    },
    "/webhook-endpoints/{id}/deliveries": {
      "get": {
        "operationId": "webhookEndpoints.listDeliveries",
        "summary": "Lister les envois",
        "description": "Les envois du point de réception, du plus récent au plus ancien, avec leurs tentatives et leur dernier résultat.",
        "tags": [
          "Webhooks"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "L'identifiant LexOpti, tel que la création ou une liste l'a renvoyé (retrouvez un client ou un dossier par votre propre référence avec `?external_ref=`)."
            },
            "description": "L'identifiant LexOpti, tel que la création ou une liste l'a renvoyé (retrouvez un client ou un dossier par votre propre référence avec `?external_ref=`)."
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 25,
              "description": "Taille de page, de 1 à 100."
            },
            "allowEmptyValue": true,
            "allowReserved": true,
            "description": "Taille de page, de 1 à 100."
          },
          {
            "name": "cursor",
            "in": "query",
            "schema": {
              "type": "string",
              "description": "`next_cursor` de la page précédente ; à omettre pour la première page."
            },
            "allowEmptyValue": true,
            "allowReserved": true,
            "description": "`next_cursor` de la page précédente ; à omettre pour la première page."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/WebhookDelivery"
                      }
                    },
                    "has_more": {
                      "type": "boolean"
                    },
                    "next_cursor": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "À passer en `cursor` pour lire la page suivante ; null sur la dernière."
                    }
                  },
                  "required": [
                    "data",
                    "has_more",
                    "next_cursor"
                  ]
                }
              }
            },
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              },
              "RateLimit": {
                "description": "Requêtes restantes et secondes avant la réinitialisation de la fenêtre.",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Policy": {
                "description": "Requêtes autorisées par fenêtre, par application.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Requête invalide : `validation_failed` liste les champs invalides.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Jeton absent, invalide ou expiré, ou accès du membre à l'application terminé (`invalid_token`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Portée manquante (`insufficient_scope`), membre en lecture seule (`readonly_member`), ou action que l'abonnement de l'organisation refuse.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Introuvable dans l'organisation à laquelle le jeton est lié (`not_found`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Conflit : une requête avec la même `Idempotency-Key` est encore en cours.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Cette `Idempotency-Key` a servi à une autre requête.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Limite de débit atteinte (`rate_limited`) ; réessayez après `Retry-After` secondes.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Erreur inattendue (`internal_error`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          }
        },
        "security": [
          {
            "oauth2": [
              "lexopti:read"
            ]
          }
        ],
        "x-codeSamples": [
          {
            "lang": "typescript",
            "label": "TypeScript",
            "source": "import { createLexOptiClient } from \"@lexopti/sdk\";\n\nconst lexopti = createLexOptiClient({ accessToken: () => process.env.LEXOPTI_TOKEN ?? \"\" });\n\nconst page = await lexopti.webhookEndpoints.listDeliveries({\n\tid: \"5e2a9c1d-7f3b-4a68-9d0e-2b1c4f6a8e3d\",\n});\nfor (const delivery of page.data) {\n\tconsole.log(delivery.type, delivery.status, delivery.attempts);\n}"
          },
          {
            "lang": "curl",
            "label": "curl",
            "source": "curl -X GET \"https://app.lexopti.com/v1/webhook-endpoints/:id/deliveries\" \\\n  -H \"Authorization: Bearer $LEXOPTI_TOKEN\""
          },
          {
            "lang": "php",
            "label": "PHP",
            "source": "$response = (new GuzzleHttp\\Client())->request('GET', 'https://app.lexopti.com/v1/webhook-endpoints/:id/deliveries', [\n    'headers' => ['Authorization' => 'Bearer ' . getenv('LEXOPTI_TOKEN')],\n]);"
          }
        ]
      }
    },
    "/webhook-endpoints/{id}/deliveries/{delivery_id}/replay": {
      "post": {
        "operationId": "webhookEndpoints.replayDelivery",
        "summary": "Rejouer un envoi",
        "description": "Renvoie le même événement, avec le même `webhook-id`, comme un nouvel envoi.",
        "tags": [
          "Webhooks"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "L'identifiant LexOpti, tel que la création ou une liste l'a renvoyé (retrouvez un client ou un dossier par votre propre référence avec `?external_ref=`)."
            },
            "description": "L'identifiant LexOpti, tel que la création ou une liste l'a renvoyé (retrouvez un client ou un dossier par votre propre référence avec `?external_ref=`)."
          },
          {
            "name": "delivery_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "L'identifiant de l'envoi, issu de `GET /v1/webhook-endpoints/{id}/deliveries`."
            },
            "description": "L'identifiant de l'envoi, issu de `GET /v1/webhook-endpoints/{id}/deliveries`."
          }
        ],
        "responses": {
          "202": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WebhookDelivery"
                }
              }
            },
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              },
              "RateLimit": {
                "description": "Requêtes restantes et secondes avant la réinitialisation de la fenêtre.",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Policy": {
                "description": "Requêtes autorisées par fenêtre, par application.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Requête invalide : `validation_failed` liste les champs invalides.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Jeton absent, invalide ou expiré, ou accès du membre à l'application terminé (`invalid_token`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Portée manquante (`insufficient_scope`), membre en lecture seule (`readonly_member`), ou action que l'abonnement de l'organisation refuse.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Introuvable dans l'organisation à laquelle le jeton est lié (`not_found`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Conflit : une requête avec la même `Idempotency-Key` est encore en cours.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Cette `Idempotency-Key` a servi à une autre requête.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Limite de débit atteinte (`rate_limited`) ; réessayez après `Retry-After` secondes.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Erreur inattendue (`internal_error`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          }
        },
        "security": [
          {
            "oauth2": [
              "lexopti:write"
            ]
          }
        ],
        "x-codeSamples": [
          {
            "lang": "typescript",
            "label": "TypeScript",
            "source": "import { createLexOptiClient } from \"@lexopti/sdk\";\n\nconst lexopti = createLexOptiClient({ accessToken: () => process.env.LEXOPTI_TOKEN ?? \"\" });\n\nconst delivery = await lexopti.webhookEndpoints.replayDelivery({\n\tid: \"5e2a9c1d-7f3b-4a68-9d0e-2b1c4f6a8e3d\",\n\tdelivery_id: \"d1f2e3a4-b5c6-4d7e-8f90-a1b2c3d4e5f6\",\n});\nconsole.log(delivery.id, delivery.replay_of);"
          },
          {
            "lang": "curl",
            "label": "curl",
            "source": "curl -X POST \"https://app.lexopti.com/v1/webhook-endpoints/:id/deliveries/:delivery_id/replay\" \\\n  -H \"Authorization: Bearer $LEXOPTI_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Idempotency-Key: $(uuidgen)\" \\\n  -d '{}'"
          },
          {
            "lang": "php",
            "label": "PHP",
            "source": "$response = (new GuzzleHttp\\Client())->request('POST', 'https://app.lexopti.com/v1/webhook-endpoints/:id/deliveries/:delivery_id/replay', [\n    'headers' => ['Authorization' => 'Bearer ' . getenv('LEXOPTI_TOKEN'), 'Idempotency-Key' => uniqid('', true)],\n    'json' => [],\n]);"
          }
        ]
      }
    },
    "/usage": {
      "get": {
        "operationId": "usage.get",
        "summary": "Lire la consommation de l'organisation",
        "description": "Le solde de crédits et les dossiers de l'organisation, pour prévenir un membre avant qu'une analyse soit refusée.",
        "tags": [
          "Organization"
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "unit": {
                      "const": "credit",
                      "description": "Ce que comptent les chiffres : des crédits. Un crédit = un dossier de cinq personnes ou sociétés au plus pendant douze mois, renouvelable."
                    },
                    "credits": {
                      "type": "object",
                      "properties": {
                        "balance": {
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991,
                          "description": "Crédits que l'organisation peut dépenser maintenant : une analyse est refusée (`quota_exceeded`) quand son dossier en demande davantage."
                        },
                        "frozen": {
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991,
                          "description": "Crédits de recharge conservés tant qu'aucune offre ne court : à nouveau dépensables dès qu'une offre reprend."
                        },
                        "low_balance_threshold": {
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991,
                          "description": "À partir de ce solde, LexOpti prévient les membres de l'organisation : prévenez aussi les vôtres."
                        }
                      },
                      "required": [
                        "balance",
                        "frozen",
                        "low_balance_threshold"
                      ]
                    },
                    "dossiers": {
                      "type": "object",
                      "properties": {
                        "active": {
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991,
                          "description": "Dossiers dans leur année payée (ou d'essai)."
                        },
                        "paused": {
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991,
                          "description": "Dossiers à renouveler sans crédit : en pause jusqu'à l'arrivée d'un crédit."
                        },
                        "renewals_due": {
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991,
                          "description": "Dossiers en cours dont l'anniversaire tombe dans les 30 jours."
                        },
                        "renewal_credits": {
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991,
                          "description": "Crédits que prendront ces renouvellements."
                        }
                      },
                      "required": [
                        "active",
                        "paused",
                        "renewals_due",
                        "renewal_credits"
                      ],
                      "description": "Les dossiers de l'organisation, selon où en est leur année payée."
                    },
                    "subscription_active": {
                      "type": "boolean",
                      "description": "Une offre court (un abonnement, une année payée encore en cours, une attribution manuelle) : les crédits sont dépensables et la vigilance court. Faux : les analyses sont refusées (`subscription_inactive`) jusqu'à un nouvel abonnement."
                    },
                    "read_only": {
                      "type": "boolean",
                      "description": "Aucune offre ne court et il ne reste aucun crédit : les lectures fonctionnent, les analyses et les nouveaux clients sont refusés."
                    }
                  },
                  "required": [
                    "unit",
                    "credits",
                    "dossiers",
                    "subscription_active",
                    "read_only"
                  ]
                }
              }
            },
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              },
              "RateLimit": {
                "description": "Requêtes restantes et secondes avant la réinitialisation de la fenêtre.",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Policy": {
                "description": "Requêtes autorisées par fenêtre, par application.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Requête invalide : `validation_failed` liste les champs invalides.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Jeton absent, invalide ou expiré, ou accès du membre à l'application terminé (`invalid_token`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Portée manquante (`insufficient_scope`), membre en lecture seule (`readonly_member`), ou action que l'abonnement de l'organisation refuse.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Introuvable dans l'organisation à laquelle le jeton est lié (`not_found`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Conflit : une requête avec la même `Idempotency-Key` est encore en cours.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Cette `Idempotency-Key` a servi à une autre requête.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Limite de débit atteinte (`rate_limited`) ; réessayez après `Retry-After` secondes.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Erreur inattendue (`internal_error`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          }
        },
        "security": [
          {
            "oauth2": [
              "lexopti:read"
            ]
          }
        ],
        "x-codeSamples": [
          {
            "lang": "typescript",
            "label": "TypeScript",
            "source": "import { createLexOptiClient } from \"@lexopti/sdk\";\n\nconst lexopti = createLexOptiClient({ accessToken: () => process.env.LEXOPTI_TOKEN ?? \"\" });\n\nconst usage = await lexopti.usage.get();\nconsole.log(usage.credits.balance, usage.dossiers.active);"
          },
          {
            "lang": "curl",
            "label": "curl",
            "source": "curl -X GET \"https://app.lexopti.com/v1/usage\" \\\n  -H \"Authorization: Bearer $LEXOPTI_TOKEN\""
          },
          {
            "lang": "php",
            "label": "PHP",
            "source": "$response = (new GuzzleHttp\\Client())->request('GET', 'https://app.lexopti.com/v1/usage', [\n    'headers' => ['Authorization' => 'Bearer ' . getenv('LEXOPTI_TOKEN')],\n]);"
          }
        ]
      }
    },
    "/sandbox/triggers": {
      "post": {
        "operationId": "sandboxTriggers.create",
        "summary": "Déclencher un événement de test",
        "description": "Dans une organisation bac à sable uniquement (403 `sandbox_required` ailleurs) : produit un changement comme il se produirait dans une vraie structure, par les mêmes écritures, si bien que ses événements et webhooks arrivent exactement comme en production. Une alerte de vigilance ou un changement de niveau de vigilance d'un client, le dernier crédit de l'organisation dépensé ou ses crédits rendus, ou l'accès de votre application révoqué.",
        "tags": [
          "Sandbox"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "type": {
                    "enum": [
                      "vigilance_alert",
                      "vigilance_level_change",
                      "quota_exhausted",
                      "quota_restored",
                      "access_revoked"
                    ],
                    "type": "string",
                    "description": "`vigilance_alert` : un nouveau résultat de presse défavorable sur le client lève une alerte en attente (`alert.created`, et `client.vigilance_level_changed` quand le niveau change). `vigilance_level_change` : le niveau de vigilance du client change sans alerte, jusqu'à `enhanced` ou, depuis `enhanced`, vers le bas (`client.vigilance_level_changed`). `quota_exhausted` : le dernier crédit de l'organisation est dépensé (`quota.exhausted`), et le bac à sable reste sans crédit : toute création ou vérification qui coûte est refusée avec `quota_exceeded`, comme pour une vraie structure, jusqu'à `quota_restored` ou une réinitialisation. `quota_restored` : le bac à sable retrouve ses crédits gratuits ; aucun événement. `access_revoked` : votre application perd réellement son accès au bac à sable (le consentement et les jetons de chaque membre), puis vos points de réception reçoivent `access.revoked` et sont désactivés ; le jeton de cette requête cesse de fonctionner."
                  },
                  "client_id": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Le client concerné, requis par `vigilance_alert` et `vigilance_level_change`."
                  }
                },
                "required": [
                  "type"
                ]
              },
              "examples": {
                "an_alert_on_a_client": {
                  "summary": "Une alerte sur un client",
                  "value": {
                    "type": "vigilance_alert",
                    "client_id": "6f1b8d6e-2c4a-4f5e-9b1d-3a7c2e8f4d10"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "202": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "type": {
                      "enum": [
                        "vigilance_alert",
                        "vigilance_level_change",
                        "quota_exhausted",
                        "quota_restored",
                        "access_revoked"
                      ],
                      "type": "string",
                      "description": "`vigilance_alert` : un nouveau résultat de presse défavorable sur le client lève une alerte en attente (`alert.created`, et `client.vigilance_level_changed` quand le niveau change). `vigilance_level_change` : le niveau de vigilance du client change sans alerte, jusqu'à `enhanced` ou, depuis `enhanced`, vers le bas (`client.vigilance_level_changed`). `quota_exhausted` : le dernier crédit de l'organisation est dépensé (`quota.exhausted`), et le bac à sable reste sans crédit : toute création ou vérification qui coûte est refusée avec `quota_exceeded`, comme pour une vraie structure, jusqu'à `quota_restored` ou une réinitialisation. `quota_restored` : le bac à sable retrouve ses crédits gratuits ; aucun événement. `access_revoked` : votre application perd réellement son accès au bac à sable (le consentement et les jetons de chaque membre), puis vos points de réception reçoivent `access.revoked` et sont désactivés ; le jeton de cette requête cesse de fonctionner."
                    },
                    "client_id": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "events": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "description": "Les événements que produit le déclencheur, envoyés comme les autres : ceux qu'écrit le changement aussitôt, ceux que le répartiteur en déduit (`client.vigilance_level_changed`, `access.revoked`) en quelques secondes."
                    },
                    "vigilance_level": {
                      "anyOf": [
                        {
                          "enum": [
                            "simplified",
                            "standard",
                            "enhanced"
                          ],
                          "type": "string",
                          "description": "Niveau de vigilance que LexOpti déduit des résultats d'analyse : `simplified` (vigilance allégée), `standard` ou `enhanced` (vigilance renforcée, des vérifications plus poussées). Ce n'est pas la décision du professionnel, qui est `risk_level`. [Glossaire](https://developers.lexopti.com/fr/glossary/)."
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Le niveau de vigilance du client une fois le déclencheur pris en compte."
                    },
                    "livemode": {
                      "const": false,
                      "description": "Toujours faux : les déclencheurs ne s'exécutent que dans les bacs à sable."
                    }
                  },
                  "required": [
                    "type",
                    "client_id",
                    "events",
                    "vigilance_level",
                    "livemode"
                  ]
                }
              }
            },
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              },
              "RateLimit": {
                "description": "Requêtes restantes et secondes avant la réinitialisation de la fenêtre.",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Policy": {
                "description": "Requêtes autorisées par fenêtre, par application.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Requête invalide : `validation_failed` liste les champs invalides.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Jeton absent, invalide ou expiré, ou accès du membre à l'application terminé (`invalid_token`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Portée manquante (`insufficient_scope`), membre en lecture seule (`readonly_member`), ou action que l'abonnement de l'organisation refuse.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Introuvable dans l'organisation à laquelle le jeton est lié (`not_found`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Conflit : une requête avec la même `Idempotency-Key` est encore en cours.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Cette `Idempotency-Key` a servi à une autre requête.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Limite de débit atteinte (`rate_limited`) ; réessayez après `Retry-After` secondes.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Erreur inattendue (`internal_error`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          }
        },
        "security": [
          {
            "oauth2": [
              "lexopti:write"
            ]
          }
        ],
        "x-codeSamples": [
          {
            "lang": "typescript",
            "label": "TypeScript",
            "source": "import { createLexOptiClient } from \"@lexopti/sdk\";\n\nconst lexopti = createLexOptiClient({ accessToken: () => process.env.LEXOPTI_TOKEN ?? \"\" });\n\nconst trigger = await lexopti.sandboxTriggers.create({\n\ttype: \"vigilance_alert\",\n\tclient_id: \"6f1b8d6e-2c4a-4f5e-9b1d-3a7c2e8f4d10\",\n});\nconsole.log(trigger.events, trigger.vigilance_level);"
          },
          {
            "lang": "curl",
            "label": "curl",
            "source": "curl -X POST \"https://app.lexopti.com/v1/sandbox/triggers\" \\\n  -H \"Authorization: Bearer $LEXOPTI_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Idempotency-Key: $(uuidgen)\" \\\n  -d '{\n    \"type\": \"vigilance_alert\",\n    \"client_id\": \"6f1b8d6e-2c4a-4f5e-9b1d-3a7c2e8f4d10\"\n  }'"
          },
          {
            "lang": "php",
            "label": "PHP",
            "source": "$response = (new GuzzleHttp\\Client())->request('POST', 'https://app.lexopti.com/v1/sandbox/triggers', [\n    'headers' => ['Authorization' => 'Bearer ' . getenv('LEXOPTI_TOKEN'), 'Idempotency-Key' => uniqid('', true)],\n    'json' => [\n        'type' => 'vigilance_alert',\n        'client_id' => '6f1b8d6e-2c4a-4f5e-9b1d-3a7c2e8f4d10',\n    ],\n]);"
          }
        ]
      }
    },
    "/deep-links": {
      "post": {
        "operationId": "deepLinks.create",
        "summary": "Créer un lien profond",
        "description": "Un lien signé qui ouvre un client ou un dossier dans LexOpti, dans la bonne organisation. À usage unique, valable 5 minutes : créez-le au clic du membre.",
        "tags": [
          "Organization"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "client_id": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Le client que le lien ouvre. Donnez-le, ou `case_id`, pas les deux."
                  },
                  "case_id": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Le dossier que le lien ouvre. Donnez-la, ou `client_id`, pas les deux."
                  }
                },
                "description": "Ce que le lien ouvre dans LexOpti : exactement un de `client_id` et `case_id`."
              },
              "examples": {
                "open_a_client": {
                  "summary": "Ouvrir un client",
                  "value": {
                    "client_id": "6f1b8d6e-2c4a-4f5e-9b1d-3a7c2e8f4d10"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri",
                      "description": "Ouvre le client ou le dossier dans LexOpti pour le membre, une fois ; un membre déconnecté se connecte, puis l'ouvre de nouveau."
                    },
                    "expires_at": {
                      "type": "string",
                      "format": "date-time",
                      "description": "5 minutes après sa délivrance."
                    }
                  },
                  "required": [
                    "url",
                    "expires_at"
                  ]
                }
              }
            },
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              },
              "RateLimit": {
                "description": "Requêtes restantes et secondes avant la réinitialisation de la fenêtre.",
                "schema": {
                  "type": "string"
                }
              },
              "RateLimit-Policy": {
                "description": "Requêtes autorisées par fenêtre, par application.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Requête invalide : `validation_failed` liste les champs invalides.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Jeton absent, invalide ou expiré, ou accès du membre à l'application terminé (`invalid_token`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Portée manquante (`insufficient_scope`), membre en lecture seule (`readonly_member`), ou action que l'abonnement de l'organisation refuse.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Introuvable dans l'organisation à laquelle le jeton est lié (`not_found`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Conflit : une requête avec la même `Idempotency-Key` est encore en cours.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Cette `Idempotency-Key` a servi à une autre requête.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Limite de débit atteinte (`rate_limited`) ; réessayez après `Retry-After` secondes.",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            },
            "description": "Erreur inattendue (`internal_error`).",
            "headers": {
              "Request-Id": {
                "description": "L'identifiant de la requête (`req_` et 32 caractères hexadécimaux), généré par LexOpti pour chaque requête, aussi le `request_id` d'un problème : citez-le au support LexOpti.",
                "schema": {
                  "type": "string",
                  "pattern": "^req_[0-9a-f]{32}$"
                }
              }
            }
          }
        },
        "security": [
          {
            "oauth2": [
              "lexopti:write"
            ]
          }
        ],
        "x-codeSamples": [
          {
            "lang": "typescript",
            "label": "TypeScript",
            "source": "import { createLexOptiClient } from \"@lexopti/sdk\";\n\nconst lexopti = createLexOptiClient({ accessToken: () => process.env.LEXOPTI_TOKEN ?? \"\" });\n\nconst link = await lexopti.deepLinks.create({\n\tclient_id: \"6f1b8d6e-2c4a-4f5e-9b1d-3a7c2e8f4d10\",\n});\nconsole.log(link.url, link.expires_at);"
          },
          {
            "lang": "curl",
            "label": "curl",
            "source": "curl -X POST \"https://app.lexopti.com/v1/deep-links\" \\\n  -H \"Authorization: Bearer $LEXOPTI_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Idempotency-Key: $(uuidgen)\" \\\n  -d '{\n    \"client_id\": \"6f1b8d6e-2c4a-4f5e-9b1d-3a7c2e8f4d10\"\n  }'"
          },
          {
            "lang": "php",
            "label": "PHP",
            "source": "$response = (new GuzzleHttp\\Client())->request('POST', 'https://app.lexopti.com/v1/deep-links', [\n    'headers' => ['Authorization' => 'Bearer ' . getenv('LEXOPTI_TOKEN'), 'Idempotency-Key' => uniqid('', true)],\n    'json' => [\n        'client_id' => '6f1b8d6e-2c4a-4f5e-9b1d-3a7c2e8f4d10',\n    ],\n]);"
          }
        ]
      }
    }
  },
  "tags": [
    {
      "name": "Organization",
      "description": "L'organisation à laquelle le jeton est lié, ses membres, sa consommation, les liens profonds.",
      "x-displayName": "Organisation"
    },
    {
      "name": "Firms",
      "description": "Les structures de nouveaux clients, que votre application prépare pour que leurs responsables les réclament, avec son propre jeton (client credentials). L'API les appelle firms.",
      "x-displayName": "Structures"
    },
    {
      "name": "Clients",
      "description": "Les personnes et sociétés avec lesquelles l'organisation est en relation d'affaires.",
      "x-displayName": "Clients"
    },
    {
      "name": "Checks",
      "description": "Les analyses d'un client sur l'ensemble des sources, suivies comme un tout.",
      "x-displayName": "Analyses"
    },
    {
      "name": "Cases",
      "description": "Les dossiers d'un ou plusieurs clients.",
      "x-displayName": "Dossiers"
    },
    {
      "name": "Alerts",
      "description": "Les changements d'une source sur un client en vigilance, jusqu'à leur examen par un membre.",
      "x-displayName": "Alertes"
    },
    {
      "name": "Events",
      "description": "Ce qui s'est passé, pour les intégrations qui interrogent l'API.",
      "x-displayName": "Événements"
    },
    {
      "name": "Webhooks",
      "description": "Les points de réception des événements, signés selon Standard Webhooks.",
      "x-displayName": "Webhooks"
    },
    {
      "name": "Embedded UI",
      "description": "Les sessions des composants embarqués sur une page partenaire.",
      "x-displayName": "Composants embarqués"
    },
    {
      "name": "Sandbox",
      "description": "Déclencheurs de test d'une organisation bac à sable : les événements de la production, à la demande.",
      "x-displayName": "Bac à sable"
    }
  ],
  "info": {
    "title": "API LexOpti",
    "version": "1.0.0",
    "description": "L'API publique de LexOpti, la plateforme de conformité LCB-FT (lutte contre le blanchiment et le financement du terrorisme) des professionnels assujettis, comme les avocats, les notaires, les experts-comptables ou les agents immobiliers. Les termes métier sont expliqués dans le [glossaire](https://developers.lexopti.com/fr/glossary/). Une application partenaire agit pour un membre dans une organisation, avec les droits de ce membre (OAuth 2.1, code d'autorisation avec PKCE). Versionnée par le chemin : `/v1` n'évolue que par ajouts ; un retrait est annoncé par les en-têtes `Deprecation` et `Sunset` 12 mois à l'avance.",
    "contact": {
      "name": "LexOpti",
      "email": "contact@lexopti.com",
      "url": "https://developers.lexopti.com"
    },
    "termsOfService": "https://developers.lexopti.com/terms"
  },
  "servers": [
    {
      "url": "https://app.lexopti.com/v1",
      "description": "Production"
    }
  ],
  "components": {
    "securitySchemes": {
      "oauth2": {
        "type": "oauth2",
        "description": "Un membre autorise l'application pour l'une de ses organisations. Les jetons d'accès durent 15 minutes ; les jetons de rafraîchissement tournent (`offline_access`).",
        "flows": {
          "authorizationCode": {
            "authorizationUrl": "https://app.lexopti.com/api/auth/oauth2/authorize",
            "tokenUrl": "https://app.lexopti.com/api/auth/oauth2/token",
            "refreshUrl": "https://app.lexopti.com/api/auth/oauth2/token",
            "scopes": {
              "lexopti:read": "Read the organization's clients, checks, cases, alerts and events.",
              "lexopti:write": "Create clients, launch checks, review alerts, manage webhooks.",
              "offline_access": "Keep access with a refresh token.",
              "openid": "Identify the member.",
              "email": "Read the member's e-mail address."
            }
          }
        }
      },
      "oauth2Application": {
        "type": "oauth2",
        "description": "Le jeton propre à votre application, pour les structures qu'elle prépare pour leurs responsables (`/v1/firms`) : client credentials avec votre secret client, `resource` l'API, scope `lexopti:firms`. Seulement pour une application autorisée en production. Les jetons durent 15 minutes, sans jeton de rafraîchissement : demandez-en un nouveau.",
        "flows": {
          "clientCredentials": {
            "tokenUrl": "https://app.lexopti.com/api/auth/oauth2/token",
            "scopes": {
              "lexopti:firms": "Prepare organizations for their managers to claim, and follow them."
            }
          }
        }
      }
    },
    "schemas": {
      "Alert": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "L'identifiant LexOpti de l'alerte."
          },
          "client_id": {
            "type": "string",
            "description": "Le client concerné par l'alerte."
          },
          "case_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Le dossier, quand l'alerte concerne une de ses parties ; null sinon."
          },
          "entity_id": {
            "type": "string",
            "description": "La personne ou la société concernée."
          },
          "source": {
            "anyOf": [
              {
                "enum": [
                  "international_sanctions",
                  "eu_sanctions",
                  "french_asset_freezes",
                  "politically_exposed_persons",
                  "high_risk_countries",
                  "bodacc_announcements",
                  "bodacc_insolvency",
                  "company_register",
                  "adverse_media"
                ],
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Le type de source qui a changé ; null quand il est inconnu."
          },
          "status": {
            "enum": [
              "pending",
              "reviewed",
              "dismissed",
              "confirmed"
            ],
            "type": "string",
            "description": "`pending` jusqu'à l'examen ; `reviewed` (pris en compte), `dismissed` (écarté) ou `confirmed` (risque confirmé)."
          },
          "level": {
            "enum": [
              "simplified",
              "standard",
              "enhanced"
            ],
            "type": "string",
            "description": "Niveau de vigilance que LexOpti déduit des résultats d'analyse : `simplified` (vigilance allégée), `standard` ou `enhanced` (vigilance renforcée, des vérifications plus poussées). Ce n'est pas la décision du professionnel, qui est `risk_level`. [Glossaire](https://developers.lexopti.com/fr/glossary/)."
          },
          "change": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Ce qui a changé : `new` (une nouvelle correspondance), `new_source` (une autre source désigne la même personne), `modified` (une nouvelle sanction dans une source connue), `requalified` (une source a changé la façon dont elle classe la personne), `reopened` (une correspondance écartée correspond de nouveau), `merged` ou `folded` (une autre fiche s'est révélée être la même personne) ; null quand c'est inconnu."
          },
          "subject": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "La personne que la source désigne."
          },
          "detail": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Les détails que donne la source sur le changement."
          },
          "source_name": {
            "type": "string",
            "description": "La liste ou le registre, sous son propre nom."
          },
          "url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Un lien vers la fiche de la source, quand elle en donne un."
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "Date de création (ISO 8601, UTC)."
          },
          "reviewed_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "Date de l'examen par un membre ; null tant qu'elle est `pending`."
          },
          "review_notes": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "La note du membre sur son examen, s'il y en a une."
          }
        },
        "required": [
          "id",
          "client_id",
          "case_id",
          "entity_id",
          "source",
          "status",
          "level",
          "change",
          "subject",
          "detail",
          "source_name",
          "url",
          "created_at",
          "reviewed_at",
          "review_notes"
        ]
      },
      "Case": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "L'identifiant LexOpti du dossier."
          },
          "external_ref": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^[A-Za-z0-9:._-]{1,255}$",
                "description": "Votre propre identifiant de l'enregistrement, par exemple `crm:contact:1042` : 1 à 255 caractères parmi `A-Z a-z 0-9 : . _ -`, unique par application, organisation et type (client ou dossier). Un identifiant technique opaque, jamais une donnée personnelle (ni nom, ni date de naissance, ni e-mail…). Visible de votre seule application."
              },
              {
                "type": "null"
              }
            ],
            "description": "La référence de votre application pour le dossier, null si elle n'en a pas. La référence d'une autre application n'est jamais montrée."
          },
          "label": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Le titre du dossier, tel que LexOpti l'affiche."
          },
          "type": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Le type de dossier, tel que la politique de la profession le nomme : le premier de `types`."
          },
          "types": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Toutes les natures du dossier, la première étant `type` (un dossier peut en avoir plusieurs, comme l'écran de LexOpti les choisit)."
          },
          "type_label": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Nature libre, lorsque `type` vaut `custom`."
          },
          "status": {
            "enum": [
              "pending",
              "running",
              "completed",
              "failed"
            ],
            "type": "string",
            "description": "Où en est le lancement propre au dossier (`launch_checks` à la création, `POST /v1/cases/{id}/checks`, ou le bouton « Lancer les analyses » dans LexOpti) : `pending` (aucun lancé), `running` (en cours), `completed` (toutes les sources ont répondu) ou `failed` (une source n'a pas pu être interrogée). Une analyse facturée au dossier par `POST /v1/checks` avec `case_id` a son propre statut et ne change pas celui-ci : lisez `pending_alert_count` et les analyses pour les résultats des clients."
          },
          "client_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Le client principal."
          },
          "client_ids": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Tous les clients du dossier, le principal en premier."
          },
          "clients": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "description": "L'identifiant LexOpti du client."
                },
                "external_ref": {
                  "anyOf": [
                    {
                      "type": "string",
                      "pattern": "^[A-Za-z0-9:._-]{1,255}$",
                      "description": "Votre propre identifiant de l'enregistrement, par exemple `crm:contact:1042` : 1 à 255 caractères parmi `A-Z a-z 0-9 : . _ -`, unique par application, organisation et type (client ou dossier). Un identifiant technique opaque, jamais une donnée personnelle (ni nom, ni date de naissance, ni e-mail…). Visible de votre seule application."
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "La référence de votre application pour le client, null si elle n'en a pas."
                },
                "main": {
                  "type": "boolean",
                  "description": "Le client principal du dossier."
                }
              },
              "required": [
                "id",
                "external_ref",
                "main"
              ]
            },
            "description": "Tous les clients du dossier, le principal en premier, avec vos références."
          },
          "parties": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "description": "L'identifiant de la partie dans ce dossier (un autre dossier donne un autre identifiant à la même personne ou société ; `entity_id` reste le même)."
                },
                "entity_id": {
                  "type": "string",
                  "description": "La personne ou la société : la même dans tous les dossiers dont elle est partie."
                },
                "external_ref": {
                  "anyOf": [
                    {
                      "type": "string",
                      "pattern": "^[A-Za-z0-9:._-]{1,255}$",
                      "description": "Votre propre identifiant de l'enregistrement, par exemple `crm:contact:1042` : 1 à 255 caractères parmi `A-Z a-z 0-9 : . _ -`, unique par application, organisation et type (client ou dossier). Un identifiant technique opaque, jamais une donnée personnelle (ni nom, ni date de naissance, ni e-mail…). Visible de votre seule application."
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "La référence de votre application pour la personne ou la société (un contact de votre logiciel qui n'est pas client), la même dans tous les dossiers dont elle est partie ; null si vous n'en avez défini aucune."
                },
                "role": {
                  "enum": [
                    "demandeur",
                    "defendeur",
                    "appelant",
                    "intime",
                    "intervenant",
                    "partie_adverse",
                    "vendeur",
                    "acquereur",
                    "cedant",
                    "cessionnaire",
                    "contrepartie",
                    "bailleur",
                    "locataire",
                    "preteur",
                    "emprunteur",
                    "caution",
                    "tiers_payeur",
                    "donateur",
                    "donataire",
                    "heritier_legataire",
                    "mandant",
                    "mandataire",
                    "representant_legal",
                    "intermediaire",
                    "associe",
                    "constituant",
                    "fiduciaire",
                    "beneficiaire",
                    "tiers",
                    "autre"
                  ],
                  "type": "string",
                  "description": "Le rôle de la partie dans le dossier, un code stable en français (`vendeur`, `acquereur`, `tiers_payeur`…). Chaque profession propose les siens ; un rôle qu'elle ne propose plus reste affiché sur une partie plus ancienne. De nouveaux rôles peuvent s'ajouter : affichez un rôle inconnu comme `autre`."
                },
                "type": {
                  "enum": [
                    "person",
                    "company"
                  ],
                  "type": "string",
                  "description": "`person` ou `company`."
                },
                "name": {
                  "type": "string",
                  "description": "Nom affiché."
                },
                "monitoring_enabled": {
                  "type": "boolean",
                  "description": "Vigilance continue : la partie est réanalysée quand les sources évoluent."
                }
              },
              "required": [
                "id",
                "entity_id",
                "external_ref",
                "role",
                "type",
                "name",
                "monitoring_enabled"
              ],
              "description": "Une partie du dossier qui n'est pas l'un de ses clients (l'autre partie, un financeur…), avec son rôle."
            },
            "description": "Les autres parties du dossier, avec leurs rôles."
          },
          "transaction_amount": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Le montant de l'opération, tel qu'un membre l'a saisi dans LexOpti : texte libre, sans unité ni format fixe. Null quand il n'est pas renseigné."
          },
          "monitoring_enabled": {
            "type": "boolean",
            "description": "Vigilance continue : le dossier est réanalysée quand les sources évoluent."
          },
          "vigilance_level": {
            "anyOf": [
              {
                "enum": [
                  "simplified",
                  "standard",
                  "enhanced"
                ],
                "type": "string",
                "description": "Niveau de vigilance que LexOpti déduit des résultats d'analyse : `simplified` (vigilance allégée), `standard` ou `enhanced` (vigilance renforcée, des vérifications plus poussées). Ce n'est pas la décision du professionnel, qui est `risk_level`. [Glossaire](https://developers.lexopti.com/fr/glossary/)."
              },
              {
                "type": "null"
              }
            ],
            "description": "Niveau de vigilance que LexOpti déduit des résultats d'analyse du dossier : `simplified` (vigilance allégée), `standard` ou `enhanced` (vigilance renforcée). Null jusqu'à la première analyse du dossier. Ce n'est pas la décision du professionnel, qui est `risk_level`."
          },
          "risk_level": {
            "anyOf": [
              {
                "enum": [
                  "simplified",
                  "standard",
                  "enhanced"
                ],
                "type": "string",
                "description": "Niveau de vigilance que LexOpti déduit des résultats d'analyse : `simplified` (vigilance allégée), `standard` ou `enhanced` (vigilance renforcée, des vérifications plus poussées). Ce n'est pas la décision du professionnel, qui est `risk_level`. [Glossaire](https://developers.lexopti.com/fr/glossary/)."
              },
              {
                "type": "null"
              }
            ],
            "description": "Niveau de risque du dossier, validé par le professionnel dans LexOpti et calculé sans les éléments de soupçon, qui restent confidentiels. `null` tant qu'il ne l'a pas fixé. En lecture seule : l'API ne peut pas le modifier."
          },
          "classification_state": {
            "enum": [
              "to_complete",
              "in_progress",
              "validated",
              "revalidate"
            ],
            "type": "string",
            "description": "L'état de la classification du dossier ; lisez-la avec `GET /v1/cases/{id}/classification`."
          },
          "has_pending_alert": {
            "type": "boolean",
            "description": "Au moins une alerte attend l'examen d'un membre."
          },
          "pending_alert_count": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "Les alertes en attente de l'examen d'un membre, comme la page du dossier les montre : celles de chaque client du dossier et de ses parties."
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "Date de création (ISO 8601, UTC)."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time",
            "description": "Date de dernière modification (ISO 8601, UTC)."
          }
        },
        "required": [
          "id",
          "external_ref",
          "label",
          "type",
          "types",
          "type_label",
          "status",
          "client_id",
          "client_ids",
          "clients",
          "parties",
          "transaction_amount",
          "monitoring_enabled",
          "vigilance_level",
          "risk_level",
          "classification_state",
          "has_pending_alert",
          "pending_alert_count",
          "created_at",
          "updated_at"
        ]
      },
      "Check": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "L'identifiant LexOpti de l'analyse."
          },
          "client_id": {
            "type": "string",
            "description": "Le client analysé."
          },
          "status": {
            "enum": [
              "running",
              "completed",
              "failed"
            ],
            "type": "string",
            "description": "`running` jusqu'à la réponse de chaque source ; `failed` si l'une d'elles n'a pas pu être interrogée."
          },
          "sources": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "source": {
                  "enum": [
                    "international_sanctions",
                    "eu_sanctions",
                    "french_asset_freezes",
                    "politically_exposed_persons",
                    "high_risk_countries",
                    "bodacc_announcements",
                    "bodacc_insolvency",
                    "company_register",
                    "adverse_media"
                  ],
                  "type": "string"
                },
                "entity_id": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "La personne ou la société analysée : le client ou une partie liée."
                },
                "status": {
                  "enum": [
                    "pending",
                    "running",
                    "completed",
                    "failed",
                    "skipped"
                  ],
                  "type": "string"
                },
                "completed_at": {
                  "anyOf": [
                    {
                      "type": "string",
                      "format": "date-time"
                    },
                    {
                      "type": "null"
                    }
                  ]
                }
              },
              "required": [
                "source",
                "entity_id",
                "status",
                "completed_at"
              ]
            },
            "description": "Une entrée par source et par entité analysée. Vide quand rien n'était à analyser."
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "Date de création (ISO 8601, UTC)."
          },
          "completed_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "Date à laquelle toutes les sources ont répondu (`completed` ou `failed`) ; null tant qu'elle est `running`."
          }
        },
        "required": [
          "id",
          "client_id",
          "status",
          "sources",
          "created_at",
          "completed_at"
        ]
      },
      "Classification": {
        "type": "object",
        "properties": {
          "subject": {
            "enum": [
              "client",
              "case"
            ],
            "type": "string",
            "description": "`client` : l'évaluation de risque propre au client (les questions sur le client et les personnes qui lui sont liées, `axe2`) ; `case` : celle d’un dossier, tous les axes, avec les réponses `axe2` de ses clients."
          },
          "client_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Le client, pour `subject: client` ; sinon null."
          },
          "case_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Le dossier, pour `subject: case` ; sinon null."
          },
          "state": {
            "enum": [
              "to_complete",
              "in_progress",
              "validated",
              "revalidate"
            ],
            "type": "string",
            "description": "`to_complete` : aucune réponse encore ; `in_progress` : des réponses enregistrées, non validées ; `validated` : validée ; `revalidate` : validée, mais les analyses, les personnes ou les réponses ont changé depuis, un membre doit donc la valider de nouveau."
          },
          "policy": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "version": {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              }
            },
            "required": [
              "id",
              "version"
            ],
            "description": "La version du questionnaire qu'utilise la profession de l'organisation, par exemple `lawyer-cnb-asr-2023` pour les avocats. Un identifiant opaque : comparez-le, ne le découpez pas."
          },
          "score": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Score de risque de 0 à 4, tel que LexOpti le calcule à partir des réponses enregistrées ; null tant que rien n'est noté."
          },
          "level": {
            "anyOf": [
              {
                "enum": [
                  "simplified",
                  "standard",
                  "enhanced"
                ],
                "type": "string",
                "description": "Niveau de vigilance que LexOpti déduit des résultats d'analyse : `simplified` (vigilance allégée), `standard` ou `enhanced` (vigilance renforcée, des vérifications plus poussées). Ce n'est pas la décision du professionnel, qui est `risk_level`. [Glossaire](https://developers.lexopti.com/fr/glossary/)."
              },
              {
                "type": "null"
              }
            ],
            "description": "Niveau de vigilance que donne le score : `simplified` (simplifiée), `standard` ou `enhanced` (renforcée) ; null tant qu'aucune réponse n'est enregistrée."
          },
          "validated_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "La dernière validation par un membre ; null jusqu'à la première."
          },
          "validated_by": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "user_id": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Le membre qui a validé ; null s'il n'est plus connu."
                  },
                  "channel": {
                    "anyOf": [
                      {
                        "enum": [
                          "app",
                          "embed",
                          "api",
                          "mcp"
                        ],
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Où : `app` (LexOpti) ou `embed` (ses écrans embarqués dans une application partenaire) ; null si ce n'est plus connu."
                  }
                },
                "required": [
                  "user_id",
                  "channel"
                ]
              },
              {
                "type": "null"
              }
            ],
            "description": "Qui a fait la dernière validation ; null jusqu'à la première."
          },
          "answers": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "question_id": {
                  "type": "string",
                  "description": "L'identifiant de la question dans le questionnaire (`q2`, `q10_p`…), stable au sein d'une `policy`."
                },
                "axis": {
                  "type": "string",
                  "description": "L'axe (la section) du questionnaire auquel appartient la question : `axe1` (l'entrée en relation), `axe2` (le client et les personnes qui lui sont liées), `axe3` (la prestation), `axe4` (l'opération). Le cinquième axe, le soupçon, n'est jamais renvoyé. [Glossaire](https://developers.lexopti.com/fr/glossary/)."
                },
                "value": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "La réponse : `yes` ou `no` pour une question oui/non ; sinon la valeur de l'option, un code ISO 3166-1 alpha-2, des valeurs séparées par des virgules pour un choix multiple, ou le texte saisi. Null quand seul `per_entity` est renseigné."
                },
                "linked_entity_ids": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "Les personnes que concerne une réponse de risque, parmi le client et ses parties liées."
                },
                "per_entity": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "entity_id": {
                        "type": "string"
                      },
                      "value": {
                        "type": "string",
                        "description": "Mêmes valeurs que `value`."
                      }
                    },
                    "required": [
                      "entity_id",
                      "value"
                    ]
                  },
                  "description": "Une question répondue personne par personne : une entrée chacune."
                }
              },
              "required": [
                "question_id",
                "axis",
                "value",
                "linked_entity_ids",
                "per_entity"
              ]
            },
            "description": "Les réponses enregistrées, dans l'ordre du questionnaire. Les propositions de préremplissage qu'un membre n'a pas enregistrées ne sont pas des réponses."
          },
          "excluded_axes": {
            "type": "array",
            "items": {
              "enum": [
                "axe5"
              ],
              "type": "string"
            },
            "description": "Les axes que l'API ne renvoie jamais : `axe5`, le soupçon (ce que le professionnel sait ou soupçonne du client). La loi interdit de le divulguer (art. L. 561-18 du Code monétaire et financier) : ni ses réponses ni leur effet sur le score et le niveau ne sortent de LexOpti, et `missing_answers` ne le compte pas. Le membre le voit dans LexOpti et dans les composants embarqués."
          },
          "missing_answers": {
            "type": "object",
            "properties": {
              "count": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "question_ids": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            },
            "required": [
              "count",
              "question_ids"
            ],
            "description": "Les questions encore sans réponse, telles que le formulaire de classification les compte pour ces réponses et ces personnes."
          }
        },
        "required": [
          "subject",
          "client_id",
          "case_id",
          "state",
          "policy",
          "score",
          "level",
          "validated_at",
          "validated_by",
          "answers",
          "excluded_axes",
          "missing_answers"
        ]
      },
      "Client": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "L'identifiant LexOpti du client."
          },
          "external_ref": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^[A-Za-z0-9:._-]{1,255}$",
                "description": "Votre propre identifiant de l'enregistrement, par exemple `crm:contact:1042` : 1 à 255 caractères parmi `A-Z a-z 0-9 : . _ -`, unique par application, organisation et type (client ou dossier). Un identifiant technique opaque, jamais une donnée personnelle (ni nom, ni date de naissance, ni e-mail…). Visible de votre seule application."
              },
              {
                "type": "null"
              }
            ],
            "description": "La référence de votre application pour l'enregistrement, null s'il n'en a pas. La référence d'une autre application n'est jamais montrée."
          },
          "type": {
            "enum": [
              "person",
              "company"
            ],
            "type": "string",
            "description": "`person` ou `company`."
          },
          "name": {
            "type": "string",
            "description": "Nom affiché."
          },
          "person": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "first_name": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Prénom(s)."
                  },
                  "last_name": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Nom de famille."
                  },
                  "usage_name": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Le nom d'usage, par exemple un nom d'épouse."
                  },
                  "birth_date": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Date de naissance, `AAAA-MM-JJ`."
                  },
                  "birth_city": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Ville de naissance."
                  },
                  "birth_country": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Pays de naissance, code ISO 3166-1 alpha-2."
                  },
                  "nationalities": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Nationalités, codes ISO 3166-1 alpha-2 ; vide quand elles sont inconnues."
                  }
                },
                "required": [
                  "first_name",
                  "last_name",
                  "usage_name",
                  "birth_date",
                  "birth_city",
                  "birth_country",
                  "nationalities"
                ]
              },
              {
                "type": "null"
              }
            ],
            "description": "L'identité, avec `type: person` ; null sinon."
          },
          "company": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "name": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Dénomination sociale."
                  },
                  "siren": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "SIREN, neuf chiffres."
                  },
                  "siret": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "SIRET, 14 chiffres."
                  },
                  "legal_form": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Forme juridique."
                  },
                  "registration_country": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Pays d'immatriculation, code ISO 3166-1 alpha-2."
                  },
                  "rcs": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Immatriculation au RCS."
                  }
                },
                "required": [
                  "name",
                  "siren",
                  "siret",
                  "legal_form",
                  "registration_country",
                  "rcs"
                ]
              },
              {
                "type": "null"
              }
            ],
            "description": "L'identité, avec `type: company` ; null sinon."
          },
          "address": {
            "type": "object",
            "properties": {
              "line": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Numéro, voie et complément éventuel."
              },
              "postal_code": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Code postal."
              },
              "city": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Ville."
              },
              "country": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Code ISO 3166-1 alpha-2."
              }
            },
            "required": [
              "line",
              "postal_code",
              "city",
              "country"
            ],
            "description": "L'adresse postale ; chaque champ est null quand il est inconnu."
          },
          "monitoring_enabled": {
            "type": "boolean",
            "description": "Vigilance continue : le client est réanalysé quand les sources évoluent."
          },
          "vigilance_level": {
            "anyOf": [
              {
                "enum": [
                  "simplified",
                  "standard",
                  "enhanced"
                ],
                "type": "string",
                "description": "Niveau de vigilance que LexOpti déduit des résultats d'analyse : `simplified` (vigilance allégée), `standard` ou `enhanced` (vigilance renforcée, des vérifications plus poussées). Ce n'est pas la décision du professionnel, qui est `risk_level`. [Glossaire](https://developers.lexopti.com/fr/glossary/)."
              },
              {
                "type": "null"
              }
            ],
            "description": "Niveau de vigilance que LexOpti déduit des résultats d'analyse du client : `simplified` (vigilance allégée), `standard` ou `enhanced` (vigilance renforcée). Null jusqu'à la première analyse du client. Ce n'est pas la décision du professionnel, qui est `risk_level`."
          },
          "risk_level": {
            "anyOf": [
              {
                "enum": [
                  "simplified",
                  "standard",
                  "enhanced"
                ],
                "type": "string",
                "description": "Niveau de vigilance que LexOpti déduit des résultats d'analyse : `simplified` (vigilance allégée), `standard` ou `enhanced` (vigilance renforcée, des vérifications plus poussées). Ce n'est pas la décision du professionnel, qui est `risk_level`. [Glossaire](https://developers.lexopti.com/fr/glossary/)."
              },
              {
                "type": "null"
              }
            ],
            "description": "Niveau de risque décidé par le professionnel dans LexOpti. `null` tant qu'il ne l'a pas fixé. En lecture seule : l'API ne peut pas le modifier."
          },
          "has_pending_alert": {
            "type": "boolean",
            "description": "Une alerte sur le client attend l'examen d'un membre (`GET /v1/alerts?client_id=&status=pending`)."
          },
          "preliminary_screening": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "status": {
                    "enum": [
                      "pending",
                      "completed",
                      "failed",
                      "unavailable"
                    ],
                    "type": "string",
                    "description": "Le statut de la dernière demande. Une demande `pending`, `failed` ou `unavailable` ne remplace pas le résultat actuel : `outcome`, `match_count`, `screened_at` et `checked_at` restent ceux de la dernière recherche terminée."
                  },
                  "pending": {
                    "type": "boolean",
                    "description": "Une demande plus récente est en cours d'analyse (`status` vaut `pending`) : le résultat actuel peut bientôt changer."
                  },
                  "outcome": {
                    "anyOf": [
                      {
                        "enum": [
                          "no_match",
                          "possible_match"
                        ],
                        "type": "string",
                        "description": "`no_match` : aucune correspondance dans les listes consultées, aux versions indiquées (jamais une attestation que le client est conforme ou non gelé) ; `possible_match` : au moins une personne ou entité inscrite peut être le client, à vérifier."
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "L'issue du résultat actuel (la dernière recherche terminée) ; null tant que le client n'en a pas."
                  },
                  "match_count": {
                    "anyOf": [
                      {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 9007199254740991
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Correspondances possibles du résultat actuel, homonymes probables (date de naissance contradictoire) exclus ; null tant que le client n'a aucune recherche terminée."
                  },
                  "screened_at": {
                    "anyOf": [
                      {
                        "type": "string",
                        "format": "date-time"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Quand la recherche du résultat actuel a eu lieu ; null tant que le client n'en a pas. Une nouvelle analyse qui trouve les mêmes correspondances le garde et avance `checked_at`."
                  },
                  "checked_at": {
                    "anyOf": [
                      {
                        "type": "string",
                        "format": "date-time"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Dernière fois que le résultat actuel a été confirmé sur une publication des listes ; null tant que le client n'en a pas."
                  },
                  "last_error": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Le code d'erreur de la dernière demande quand elle est `failed` ou `unavailable`, null sinon. Pourquoi elle est `failed` ou `unavailable` : `unscreenable_subject` (aucun nom ni identifiant à rechercher), `saturated` (trop de candidats pour déclarer le client sans correspondance), `lists_not_indexed` (les listes ne sont pas encore consultables), `yente_unavailable` (le service de recherche n'a pas répondu), `screening_timeout` (la recherche n'a pas pu avoir lieu à temps), `sandbox_error` (le `ERREUR` du bac à sable). D'autres codes peuvent s'ajouter."
                  }
                },
                "required": [
                  "status",
                  "pending",
                  "outcome",
                  "match_count",
                  "screened_at",
                  "checked_at",
                  "last_error"
                ]
              },
              {
                "type": "null"
              }
            ],
            "description": "L'analyse préliminaire gratuite du client sur les listes officielles de gels et de sanctions : le statut de la dernière demande et le résultat actuel (`GET /v1/clients/{id}/preliminary-screening` pour leur détail) ; null s'il n'en a pas (un client que votre application n'a pas créé par l'API est analysé quand elle le demande : `POST /v1/clients/{id}/preliminary-screening`)."
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "Date de création (ISO 8601, UTC)."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time",
            "description": "Date de dernière modification (ISO 8601, UTC)."
          },
          "last_check": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "status": {
                    "enum": [
                      "running",
                      "completed",
                      "failed"
                    ],
                    "type": "string",
                    "description": "Comme le `status` de l'analyse elle-même."
                  },
                  "created_at": {
                    "type": "string",
                    "format": "date-time"
                  },
                  "completed_at": {
                    "anyOf": [
                      {
                        "type": "string",
                        "format": "date-time"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  }
                },
                "required": [
                  "id",
                  "status",
                  "created_at",
                  "completed_at"
                ]
              },
              {
                "type": "null"
              }
            ],
            "description": "Avec `expand[]=last_check` : la dernière analyse du client (`GET /v1/checks`), null si aucune n'a été lancée."
          },
          "open_alerts_count": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "Avec `expand[]=open_alerts_count` : le nombre d'alertes du client en attente de l'examen d'un membre, celles de ses dossiers compris, comme `GET /v1/alerts?client_id=&status=pending` les compte."
          },
          "classification_state": {
            "enum": [
              "to_complete",
              "in_progress",
              "validated",
              "revalidate"
            ],
            "type": "string",
            "description": "Avec `expand[]=classification_state` : l'état de la classification propre du client, tel que `GET /v1/clients/{id}/classification` le donne."
          },
          "cases": {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "label": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "external_ref": {
                      "anyOf": [
                        {
                          "type": "string",
                          "pattern": "^[A-Za-z0-9:._-]{1,255}$",
                          "description": "Votre propre identifiant de l'enregistrement, par exemple `crm:contact:1042` : 1 à 255 caractères parmi `A-Z a-z 0-9 : . _ -`, unique par application, organisation et type (client ou dossier). Un identifiant technique opaque, jamais une donnée personnelle (ni nom, ni date de naissance, ni e-mail…). Visible de votre seule application."
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "La référence de votre application pour le dossier, null si elle n'en a pas."
                    },
                    "risk_level": {
                      "anyOf": [
                        {
                          "enum": [
                            "simplified",
                            "standard",
                            "enhanced"
                          ],
                          "type": "string",
                          "description": "Niveau de vigilance que LexOpti déduit des résultats d'analyse : `simplified` (vigilance allégée), `standard` ou `enhanced` (vigilance renforcée, des vérifications plus poussées). Ce n'est pas la décision du professionnel, qui est `risk_level`. [Glossaire](https://developers.lexopti.com/fr/glossary/)."
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Niveau de risque du dossier, validé par le professionnel dans LexOpti et calculé sans les éléments de soupçon, qui restent confidentiels. `null` tant qu'il ne l'a pas fixé. En lecture seule : l'API ne peut pas le modifier."
                    },
                    "classification_state": {
                      "enum": [
                        "to_complete",
                        "in_progress",
                        "validated",
                        "revalidate"
                      ],
                      "type": "string",
                      "description": "`to_complete` : aucune réponse encore ; `in_progress` : des réponses enregistrées, non validées ; `validated` : validée ; `revalidate` : validée, mais les analyses, les personnes ou les réponses ont changé depuis, un membre doit donc la valider de nouveau."
                    }
                  },
                  "required": [
                    "id",
                    "label",
                    "external_ref",
                    "risk_level",
                    "classification_state"
                  ]
                }
              },
              "has_more": {
                "type": "boolean",
                "description": "D'autres dossiers existent : listez-les avec `GET /v1/cases?client_id=`."
              }
            },
            "required": [
              "data",
              "has_more"
            ],
            "description": "Avec `expand[]=cases` : les 10 derniers dossiers du client, principal ou non, du plus récent au plus ancien."
          }
        },
        "required": [
          "id",
          "external_ref",
          "type",
          "name",
          "person",
          "company",
          "address",
          "monitoring_enabled",
          "vigilance_level",
          "risk_level",
          "has_pending_alert",
          "preliminary_screening",
          "created_at",
          "updated_at"
        ]
      },
      "Event": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique par événement ; l'en-tête `webhook-id` de ses envois."
          },
          "position": {
            "type": "string",
            "pattern": "^\\d+\\.\\d+$",
            "description": "Position opaque dans le flux de l'organisation ; passez la dernière lue en `after`."
          },
          "type": {
            "x-extensible-enum": [
              "check.completed",
              "check.failed",
              "client.created",
              "client.updated",
              "client.vigilance_level_changed",
              "client.risk_level_changed",
              "client.preliminary_screening_completed",
              "classification.validated",
              "case.created",
              "case.updated",
              "case.risk_level_changed",
              "report.generated",
              "alert.created",
              "alert.resolved",
              "decision.pending",
              "quota.exhausted",
              "subscription.inactive",
              "access.revoked",
              "member.enrolled",
              "member.joined"
            ],
            "type": "string",
            "description": "Un des types d'événement du catalogue (la section `webhooks` de ce document). De nouveaux types peuvent s'ajouter : ignorez ceux que vous ne traitez pas."
          },
          "timestamp": {
            "type": "string",
            "format": "date-time",
            "description": "Date de l'événement (ISO 8601, UTC)."
          },
          "livemode": {
            "type": "boolean",
            "description": "Faux pour un événement d'une organisation bac à sable : données fictives, jamais une vraie analyse."
          },
          "data": {
            "type": "object",
            "propertyNames": {
              "type": "string"
            },
            "additionalProperties": {
              "type": "string"
            },
            "description": "Identifiants des ressources concernées (`client_id`, `case_id`, `check_id`, `alert_id`…), les clés propres à l'événement (`subject`, `changed_fields`, `kind`, `reason`… chaque type documente les siennes), et les références de votre application pour le client et le dossier (`client_external_ref`, `case_external_ref`) quand elle les a définies. Des identifiants et des noms seulement : jamais de donnée personnelle, jamais l'axe soupçon."
          }
        },
        "required": [
          "id",
          "position",
          "type",
          "timestamp",
          "livemode",
          "data"
        ]
      },
      "Problem": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "format": "uri",
            "description": "Documentation du code d'erreur."
          },
          "title": {
            "type": "string",
            "description": "Le libellé du statut HTTP."
          },
          "status": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991,
            "description": "Le code de statut HTTP."
          },
          "code": {
            "type": "string",
            "description": "Motif stable, lisible par une machine, en anglais (`not_found`, `validation_failed`…)."
          },
          "detail": {
            "type": "string",
            "description": "Explication lisible ; elle peut changer, ne l'analysez jamais."
          },
          "request_id": {
            "type": "string",
            "description": "L'identifiant de la requête, aussi son en-tête `Request-Id` : citez-le au support LexOpti."
          },
          "errors": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "path": {
                  "type": "string",
                  "description": "Pointeur JSON du champ invalide."
                },
                "message": {
                  "type": "string"
                }
              },
              "required": [
                "path",
                "message"
              ]
            },
            "description": "Champs invalides, pour `validation_failed`."
          },
          "missing": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "entity_id": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "is_main_entity": {
                  "type": "boolean"
                },
                "fields": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              },
              "required": [
                "entity_id",
                "name",
                "is_main_entity",
                "fields"
              ]
            },
            "description": "Champs d'identité à compléter, pour `incomplete_identity`."
          },
          "cases": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "name": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                }
              },
              "required": [
                "id",
                "name"
              ]
            },
            "description": "Les dossiers ouverts du client auxquels l'analyse peut être facturée, pour `dossier_required` : renvoyez l'un d'eux en `case_id` (vide : créez d'abord un dossier)."
          }
        },
        "required": [
          "type",
          "title",
          "status",
          "code",
          "detail",
          "request_id"
        ]
      },
      "WebhookDelivery": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "L'identifiant LexOpti de l'envoi."
          },
          "event_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "L'événement, l'en-tête `webhook-id` ; null pour un envoi de test."
          },
          "type": {
            "type": "string",
            "description": "Le type d'événement, ou `webhook.test`."
          },
          "status": {
            "enum": [
              "pending",
              "succeeded",
              "failed",
              "cancelled"
            ],
            "type": "string",
            "description": "`cancelled` : l'application a perdu son accès à l'organisation (bloquée, ou plus aucun consentement de membre) ; jamais compté comme un échec du point de réception."
          },
          "attempts": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991,
            "description": "Le nombre d'envois par LexOpti."
          },
          "next_attempt_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "Date du prochain envoi ; null s'il n'y en aura pas."
          },
          "last_attempt_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "Date du dernier envoi ; null avant le premier."
          },
          "last_response_status": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ],
            "description": "Le statut HTTP de la dernière réponse de votre point de réception ; null s'il n'a pas répondu."
          },
          "last_error": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "La raison de l'échec du dernier envoi, par exemple `timeout` ; null s'il n'a pas échoué."
          },
          "replay_of": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "L'envoi que celui-ci rejoue (`POST …/deliveries/{delivery_id}/replay`) ; null pour un original."
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "Date de création (ISO 8601, UTC)."
          },
          "completed_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "Date de réussite ou d'abandon ; null tant qu'il est `pending`."
          }
        },
        "required": [
          "id",
          "event_id",
          "type",
          "status",
          "attempts",
          "next_attempt_at",
          "last_attempt_at",
          "last_response_status",
          "last_error",
          "replay_of",
          "created_at",
          "completed_at"
        ]
      },
      "WebhookEndpoint": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "L'identifiant LexOpti du point de réception."
          },
          "url": {
            "type": "string",
            "format": "uri",
            "description": "L'adresse où LexOpti envoie les événements."
          },
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Votre libellé pour le point de réception."
          },
          "event_types": {
            "type": "array",
            "items": {
              "x-extensible-enum": [
                "check.completed",
                "check.failed",
                "client.created",
                "client.updated",
                "client.vigilance_level_changed",
                "client.risk_level_changed",
                "client.preliminary_screening_completed",
                "classification.validated",
                "case.created",
                "case.updated",
                "case.risk_level_changed",
                "report.generated",
                "alert.created",
                "alert.resolved",
                "decision.pending",
                "quota.exhausted",
                "subscription.inactive",
                "access.revoked",
                "member.enrolled",
                "member.joined"
              ],
              "type": "string",
              "description": "Un des types d'événement du catalogue (la section `webhooks` de ce document). De nouveaux types peuvent s'ajouter : ignorez ceux que vous ne traitez pas."
            },
            "description": "Les types d'événements qu'il reçoit."
          },
          "status": {
            "enum": [
              "enabled",
              "disabled"
            ],
            "type": "string",
            "description": "`disabled` : LexOpti n'envoie rien ; `disabled_reason` dit pourquoi."
          },
          "disabled_reason": {
            "anyOf": [
              {
                "x-extensible-enum": [
                  "failing",
                  "member",
                  "access_revoked"
                ],
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "`failing` : tous les envois ont échoué pendant un cycle complet de reprises (environ trois jours) ; réactivez-le une fois corrigé. `member` : désactivé par `PATCH`. `access_revoked` : votre application a perdu son accès à l'organisation, ce qu'a dit un dernier envoi `access.revoked` ; réactivez-le une fois qu'un membre l'a de nouveau autorisée."
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "Date de création (ISO 8601, UTC)."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time",
            "description": "Date de dernière modification (ISO 8601, UTC)."
          }
        },
        "required": [
          "id",
          "url",
          "description",
          "event_types",
          "status",
          "disabled_reason",
          "created_at",
          "updated_at"
        ]
      }
    }
  },
  "openapi": "3.1.1",
  "webhooks": {
    "check.completed": {
      "post": {
        "summary": "check.completed",
        "description": "Toutes les sources d'une analyse ont répondu. Signé selon Standard Webhooks : vérifiez `webhook-signature` avec le secret du point de réception, dédoublonnez sur `webhook-id`.",
        "operationId": "webhook.check.completed",
        "tags": [
          "Webhooks"
        ],
        "parameters": [
          {
            "name": "webhook-id",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "webhook-timestamp",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "webhook-signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "type",
                  "timestamp",
                  "livemode",
                  "data"
                ],
                "properties": {
                  "type": {
                    "const": "check.completed"
                  },
                  "livemode": {
                    "type": "boolean",
                    "description": "Faux pour un événement d'une organisation bac à sable : données fictives, jamais une vraie analyse."
                  },
                  "timestamp": {
                    "type": "string",
                    "format": "date-time"
                  },
                  "data": {
                    "type": "object",
                    "required": [
                      "check_id",
                      "client_id"
                    ],
                    "properties": {
                      "check_id": {
                        "type": "string"
                      },
                      "client_id": {
                        "type": "string"
                      },
                      "case_id": {
                        "type": "string"
                      },
                      "client_external_ref": {
                        "type": "string",
                        "description": "La référence de votre application pour le client, quand elle en a défini une."
                      },
                      "case_external_ref": {
                        "type": "string",
                        "description": "La référence de votre application pour le dossier, quand l'événement concerne un dossier et qu'elle en a défini une."
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Toute réponse 2xx accuse réception de l'envoi ; toute autre est reprise."
          }
        }
      }
    },
    "check.failed": {
      "post": {
        "summary": "check.failed",
        "description": "Une analyse s'est terminée avec une source qui n'a pas pu être interrogée. Signé selon Standard Webhooks : vérifiez `webhook-signature` avec le secret du point de réception, dédoublonnez sur `webhook-id`.",
        "operationId": "webhook.check.failed",
        "tags": [
          "Webhooks"
        ],
        "parameters": [
          {
            "name": "webhook-id",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "webhook-timestamp",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "webhook-signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "type",
                  "timestamp",
                  "livemode",
                  "data"
                ],
                "properties": {
                  "type": {
                    "const": "check.failed"
                  },
                  "livemode": {
                    "type": "boolean",
                    "description": "Faux pour un événement d'une organisation bac à sable : données fictives, jamais une vraie analyse."
                  },
                  "timestamp": {
                    "type": "string",
                    "format": "date-time"
                  },
                  "data": {
                    "type": "object",
                    "required": [
                      "check_id",
                      "client_id"
                    ],
                    "properties": {
                      "check_id": {
                        "type": "string"
                      },
                      "client_id": {
                        "type": "string"
                      },
                      "case_id": {
                        "type": "string"
                      },
                      "client_external_ref": {
                        "type": "string",
                        "description": "La référence de votre application pour le client, quand elle en a défini une."
                      },
                      "case_external_ref": {
                        "type": "string",
                        "description": "La référence de votre application pour le dossier, quand l'événement concerne un dossier et qu'elle en a défini une."
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Toute réponse 2xx accuse réception de l'envoi ; toute autre est reprise."
          }
        }
      }
    },
    "client.created": {
      "post": {
        "summary": "client.created",
        "description": "Un client a été créé : dans LexOpti, un formulaire embarqué ou par `POST /v1/clients`. Signé selon Standard Webhooks : vérifiez `webhook-signature` avec le secret du point de réception, dédoublonnez sur `webhook-id`.",
        "operationId": "webhook.client.created",
        "tags": [
          "Webhooks"
        ],
        "parameters": [
          {
            "name": "webhook-id",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "webhook-timestamp",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "webhook-signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "type",
                  "timestamp",
                  "livemode",
                  "data"
                ],
                "properties": {
                  "type": {
                    "const": "client.created"
                  },
                  "livemode": {
                    "type": "boolean",
                    "description": "Faux pour un événement d'une organisation bac à sable : données fictives, jamais une vraie analyse."
                  },
                  "timestamp": {
                    "type": "string",
                    "format": "date-time"
                  },
                  "data": {
                    "type": "object",
                    "required": [
                      "client_id"
                    ],
                    "properties": {
                      "client_id": {
                        "type": "string"
                      },
                      "case_id": {
                        "type": "string"
                      },
                      "client_external_ref": {
                        "type": "string",
                        "description": "La référence de votre application pour le client, quand elle en a défini une."
                      },
                      "case_external_ref": {
                        "type": "string",
                        "description": "La référence de votre application pour le dossier, quand l'événement concerne un dossier et qu'elle en a défini une."
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Toute réponse 2xx accuse réception de l'envoi ; toute autre est reprise."
          }
        }
      }
    },
    "client.updated": {
      "post": {
        "summary": "client.updated",
        "description": "L'identité d'un client ou sa vigilance continue a changé : `changed_fields` liste les champs publics modifiés (`person.last_name,address.city`, `monitoring_enabled`…), séparés par des virgules et triés, jamais leurs valeurs. Signé selon Standard Webhooks : vérifiez `webhook-signature` avec le secret du point de réception, dédoublonnez sur `webhook-id`.",
        "operationId": "webhook.client.updated",
        "tags": [
          "Webhooks"
        ],
        "parameters": [
          {
            "name": "webhook-id",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "webhook-timestamp",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "webhook-signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "type",
                  "timestamp",
                  "livemode",
                  "data"
                ],
                "properties": {
                  "type": {
                    "const": "client.updated"
                  },
                  "livemode": {
                    "type": "boolean",
                    "description": "Faux pour un événement d'une organisation bac à sable : données fictives, jamais une vraie analyse."
                  },
                  "timestamp": {
                    "type": "string",
                    "format": "date-time"
                  },
                  "data": {
                    "type": "object",
                    "required": [
                      "client_id",
                      "changed_fields"
                    ],
                    "properties": {
                      "client_id": {
                        "type": "string"
                      },
                      "changed_fields": {
                        "type": "string"
                      },
                      "case_id": {
                        "type": "string"
                      },
                      "client_external_ref": {
                        "type": "string",
                        "description": "La référence de votre application pour le client, quand elle en a défini une."
                      },
                      "case_external_ref": {
                        "type": "string",
                        "description": "La référence de votre application pour le dossier, quand l'événement concerne un dossier et qu'elle en a défini une."
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Toute réponse 2xx accuse réception de l'envoi ; toute autre est reprise."
          }
        }
      }
    },
    "client.vigilance_level_changed": {
      "post": {
        "summary": "client.vigilance_level_changed",
        "description": "Le niveau de vigilance que donnent les résultats d'analyse d'un client (`vigilance_level`) a changé : après une analyse, un contrôle de vigilance ou l'examen d'une correspondance par un membre. Lisez le client. Signé selon Standard Webhooks : vérifiez `webhook-signature` avec le secret du point de réception, dédoublonnez sur `webhook-id`.",
        "operationId": "webhook.client.vigilance_level_changed",
        "tags": [
          "Webhooks"
        ],
        "parameters": [
          {
            "name": "webhook-id",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "webhook-timestamp",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "webhook-signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "type",
                  "timestamp",
                  "livemode",
                  "data"
                ],
                "properties": {
                  "type": {
                    "const": "client.vigilance_level_changed"
                  },
                  "livemode": {
                    "type": "boolean",
                    "description": "Faux pour un événement d'une organisation bac à sable : données fictives, jamais une vraie analyse."
                  },
                  "timestamp": {
                    "type": "string",
                    "format": "date-time"
                  },
                  "data": {
                    "type": "object",
                    "required": [
                      "client_id"
                    ],
                    "properties": {
                      "client_id": {
                        "type": "string"
                      },
                      "case_id": {
                        "type": "string"
                      },
                      "client_external_ref": {
                        "type": "string",
                        "description": "La référence de votre application pour le client, quand elle en a défini une."
                      },
                      "case_external_ref": {
                        "type": "string",
                        "description": "La référence de votre application pour le dossier, quand l'événement concerne un dossier et qu'elle en a défini une."
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Toute réponse 2xx accuse réception de l'envoi ; toute autre est reprise."
          }
        }
      }
    },
    "client.risk_level_changed": {
      "post": {
        "summary": "client.risk_level_changed",
        "description": "Un membre a validé un autre niveau de risque pour un client. Signé selon Standard Webhooks : vérifiez `webhook-signature` avec le secret du point de réception, dédoublonnez sur `webhook-id`.",
        "operationId": "webhook.client.risk_level_changed",
        "tags": [
          "Webhooks"
        ],
        "parameters": [
          {
            "name": "webhook-id",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "webhook-timestamp",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "webhook-signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "type",
                  "timestamp",
                  "livemode",
                  "data"
                ],
                "properties": {
                  "type": {
                    "const": "client.risk_level_changed"
                  },
                  "livemode": {
                    "type": "boolean",
                    "description": "Faux pour un événement d'une organisation bac à sable : données fictives, jamais une vraie analyse."
                  },
                  "timestamp": {
                    "type": "string",
                    "format": "date-time"
                  },
                  "data": {
                    "type": "object",
                    "required": [
                      "client_id"
                    ],
                    "properties": {
                      "client_id": {
                        "type": "string"
                      },
                      "case_id": {
                        "type": "string"
                      },
                      "client_external_ref": {
                        "type": "string",
                        "description": "La référence de votre application pour le client, quand elle en a défini une."
                      },
                      "case_external_ref": {
                        "type": "string",
                        "description": "La référence de votre application pour le dossier, quand l'événement concerne un dossier et qu'elle en a défini une."
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Toute réponse 2xx accuse réception de l'envoi ; toute autre est reprise."
          }
        }
      }
    },
    "client.preliminary_screening_completed": {
      "post": {
        "summary": "client.preliminary_screening_completed",
        "description": "Une analyse préliminaire gratuite d'un client sur les listes officielles de gels et de sanctions (registre français, UE, OFAC) s'est terminée avec un résultat : `status` (`completed`, `failed`), `outcome` (`no_match`, `possible_match`) si elle est terminée, `trigger` (`initial` : votre application a créé le client par l'API ; `identity_change` : votre application a modifié un champ d'identité analysé d'un tel client ; `requested` : votre application a demandé l'analyse ; `list_update` : une nouvelle publication des listes a changé son résultat). Une recherche à laquelle les listes ne peuvent pas encore répondre (`unavailable`) n'envoie rien : LexOpti la relance et signale le résultat. Lisez `GET /v1/clients/{id}/preliminary-screening`. Signé selon Standard Webhooks : vérifiez `webhook-signature` avec le secret du point de réception, dédoublonnez sur `webhook-id`.",
        "operationId": "webhook.client.preliminary_screening_completed",
        "tags": [
          "Webhooks"
        ],
        "parameters": [
          {
            "name": "webhook-id",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "webhook-timestamp",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "webhook-signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "type",
                  "timestamp",
                  "livemode",
                  "data"
                ],
                "properties": {
                  "type": {
                    "const": "client.preliminary_screening_completed"
                  },
                  "livemode": {
                    "type": "boolean",
                    "description": "Faux pour un événement d'une organisation bac à sable : données fictives, jamais une vraie analyse."
                  },
                  "timestamp": {
                    "type": "string",
                    "format": "date-time"
                  },
                  "data": {
                    "type": "object",
                    "required": [
                      "client_id",
                      "status",
                      "trigger"
                    ],
                    "properties": {
                      "client_id": {
                        "type": "string"
                      },
                      "status": {
                        "type": "string",
                        "enum": [
                          "completed",
                          "failed"
                        ]
                      },
                      "trigger": {
                        "type": "string",
                        "enum": [
                          "initial",
                          "identity_change",
                          "list_update",
                          "requested"
                        ]
                      },
                      "outcome": {
                        "type": "string",
                        "enum": [
                          "no_match",
                          "possible_match"
                        ]
                      },
                      "case_id": {
                        "type": "string"
                      },
                      "client_external_ref": {
                        "type": "string",
                        "description": "La référence de votre application pour le client, quand elle en a défini une."
                      },
                      "case_external_ref": {
                        "type": "string",
                        "description": "La référence de votre application pour le dossier, quand l'événement concerne un dossier et qu'elle en a défini une."
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Toute réponse 2xx accuse réception de l'envoi ; toute autre est reprise."
          }
        }
      }
    },
    "classification.validated": {
      "post": {
        "summary": "classification.validated",
        "description": "Un membre a validé une classification : celle d'un client (`subject: client`, `client_id`) ou celle d’un dossier (`subject: case`, `case_id`). Une fois par validation, même quand le niveau n'a pas changé. Signé selon Standard Webhooks : vérifiez `webhook-signature` avec le secret du point de réception, dédoublonnez sur `webhook-id`.",
        "operationId": "webhook.classification.validated",
        "tags": [
          "Webhooks"
        ],
        "parameters": [
          {
            "name": "webhook-id",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "webhook-timestamp",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "webhook-signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "type",
                  "timestamp",
                  "livemode",
                  "data"
                ],
                "properties": {
                  "type": {
                    "const": "classification.validated"
                  },
                  "livemode": {
                    "type": "boolean",
                    "description": "Faux pour un événement d'une organisation bac à sable : données fictives, jamais une vraie analyse."
                  },
                  "timestamp": {
                    "type": "string",
                    "format": "date-time"
                  },
                  "data": {
                    "type": "object",
                    "required": [
                      "subject"
                    ],
                    "properties": {
                      "subject": {
                        "type": "string",
                        "enum": [
                          "client",
                          "case"
                        ]
                      },
                      "client_id": {
                        "type": "string"
                      },
                      "case_id": {
                        "type": "string"
                      },
                      "client_external_ref": {
                        "type": "string",
                        "description": "La référence de votre application pour le client, quand elle en a défini une."
                      },
                      "case_external_ref": {
                        "type": "string",
                        "description": "La référence de votre application pour le dossier, quand l'événement concerne un dossier et qu'elle en a défini une."
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Toute réponse 2xx accuse réception de l'envoi ; toute autre est reprise."
          }
        }
      }
    },
    "case.created": {
      "post": {
        "summary": "case.created",
        "description": "Un membre a créé un dossier, avec son client principal (`client_id`) quand il en a un. Signé selon Standard Webhooks : vérifiez `webhook-signature` avec le secret du point de réception, dédoublonnez sur `webhook-id`.",
        "operationId": "webhook.case.created",
        "tags": [
          "Webhooks"
        ],
        "parameters": [
          {
            "name": "webhook-id",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "webhook-timestamp",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "webhook-signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "type",
                  "timestamp",
                  "livemode",
                  "data"
                ],
                "properties": {
                  "type": {
                    "const": "case.created"
                  },
                  "livemode": {
                    "type": "boolean",
                    "description": "Faux pour un événement d'une organisation bac à sable : données fictives, jamais une vraie analyse."
                  },
                  "timestamp": {
                    "type": "string",
                    "format": "date-time"
                  },
                  "data": {
                    "type": "object",
                    "required": [
                      "case_id"
                    ],
                    "properties": {
                      "case_id": {
                        "type": "string"
                      },
                      "client_id": {
                        "type": "string"
                      },
                      "client_external_ref": {
                        "type": "string",
                        "description": "La référence de votre application pour le client, quand elle en a défini une."
                      },
                      "case_external_ref": {
                        "type": "string",
                        "description": "La référence de votre application pour le dossier, quand l'événement concerne un dossier et qu'elle en a défini une."
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Toute réponse 2xx accuse réception de l'envoi ; toute autre est reprise."
          }
        }
      }
    },
    "case.updated": {
      "post": {
        "summary": "case.updated",
        "description": "L'intitulé, les clients, les parties ou les responsables d’un dossier ont changé : `changed_fields` dit lesquels (`label`, `clients`, `parties`, `assignees`), séparés par des virgules et triés. Les responsables ne sont pas exposés : lisez le dossier pour le reste. Signé selon Standard Webhooks : vérifiez `webhook-signature` avec le secret du point de réception, dédoublonnez sur `webhook-id`.",
        "operationId": "webhook.case.updated",
        "tags": [
          "Webhooks"
        ],
        "parameters": [
          {
            "name": "webhook-id",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "webhook-timestamp",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "webhook-signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "type",
                  "timestamp",
                  "livemode",
                  "data"
                ],
                "properties": {
                  "type": {
                    "const": "case.updated"
                  },
                  "livemode": {
                    "type": "boolean",
                    "description": "Faux pour un événement d'une organisation bac à sable : données fictives, jamais une vraie analyse."
                  },
                  "timestamp": {
                    "type": "string",
                    "format": "date-time"
                  },
                  "data": {
                    "type": "object",
                    "required": [
                      "case_id",
                      "changed_fields"
                    ],
                    "properties": {
                      "case_id": {
                        "type": "string"
                      },
                      "changed_fields": {
                        "type": "string"
                      },
                      "client_id": {
                        "type": "string"
                      },
                      "client_external_ref": {
                        "type": "string",
                        "description": "La référence de votre application pour le client, quand elle en a défini une."
                      },
                      "case_external_ref": {
                        "type": "string",
                        "description": "La référence de votre application pour le dossier, quand l'événement concerne un dossier et qu'elle en a défini une."
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Toute réponse 2xx accuse réception de l'envoi ; toute autre est reprise."
          }
        }
      }
    },
    "case.risk_level_changed": {
      "post": {
        "summary": "case.risk_level_changed",
        "description": "Un membre a validé un autre niveau de risque pour un dossier. Signé selon Standard Webhooks : vérifiez `webhook-signature` avec le secret du point de réception, dédoublonnez sur `webhook-id`.",
        "operationId": "webhook.case.risk_level_changed",
        "tags": [
          "Webhooks"
        ],
        "parameters": [
          {
            "name": "webhook-id",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "webhook-timestamp",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "webhook-signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "type",
                  "timestamp",
                  "livemode",
                  "data"
                ],
                "properties": {
                  "type": {
                    "const": "case.risk_level_changed"
                  },
                  "livemode": {
                    "type": "boolean",
                    "description": "Faux pour un événement d'une organisation bac à sable : données fictives, jamais une vraie analyse."
                  },
                  "timestamp": {
                    "type": "string",
                    "format": "date-time"
                  },
                  "data": {
                    "type": "object",
                    "required": [
                      "case_id"
                    ],
                    "properties": {
                      "case_id": {
                        "type": "string"
                      },
                      "client_id": {
                        "type": "string"
                      },
                      "client_external_ref": {
                        "type": "string",
                        "description": "La référence de votre application pour le client, quand elle en a défini une."
                      },
                      "case_external_ref": {
                        "type": "string",
                        "description": "La référence de votre application pour le dossier, quand l'événement concerne un dossier et qu'elle en a défini une."
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Toute réponse 2xx accuse réception de l'envoi ; toute autre est reprise."
          }
        }
      }
    },
    "report.generated": {
      "post": {
        "summary": "report.generated",
        "description": "Un membre a produit une nouvelle version du rapport d’un dossier dont le contenu, l'axe soupçon mis à part, a changé : `GET /v1/cases/{id}/report` la sert. Signé selon Standard Webhooks : vérifiez `webhook-signature` avec le secret du point de réception, dédoublonnez sur `webhook-id`.",
        "operationId": "webhook.report.generated",
        "tags": [
          "Webhooks"
        ],
        "parameters": [
          {
            "name": "webhook-id",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "webhook-timestamp",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "webhook-signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "type",
                  "timestamp",
                  "livemode",
                  "data"
                ],
                "properties": {
                  "type": {
                    "const": "report.generated"
                  },
                  "livemode": {
                    "type": "boolean",
                    "description": "Faux pour un événement d'une organisation bac à sable : données fictives, jamais une vraie analyse."
                  },
                  "timestamp": {
                    "type": "string",
                    "format": "date-time"
                  },
                  "data": {
                    "type": "object",
                    "required": [
                      "case_id"
                    ],
                    "properties": {
                      "case_id": {
                        "type": "string"
                      },
                      "client_id": {
                        "type": "string"
                      },
                      "client_external_ref": {
                        "type": "string",
                        "description": "La référence de votre application pour le client, quand elle en a défini une."
                      },
                      "case_external_ref": {
                        "type": "string",
                        "description": "La référence de votre application pour le dossier, quand l'événement concerne un dossier et qu'elle en a défini une."
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Toute réponse 2xx accuse réception de l'envoi ; toute autre est reprise."
          }
        }
      }
    },
    "alert.created": {
      "post": {
        "summary": "alert.created",
        "description": "Une source a changé au sujet d'un client en vigilance ou d'une de ses parties. Signé selon Standard Webhooks : vérifiez `webhook-signature` avec le secret du point de réception, dédoublonnez sur `webhook-id`.",
        "operationId": "webhook.alert.created",
        "tags": [
          "Webhooks"
        ],
        "parameters": [
          {
            "name": "webhook-id",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "webhook-timestamp",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "webhook-signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "type",
                  "timestamp",
                  "livemode",
                  "data"
                ],
                "properties": {
                  "type": {
                    "const": "alert.created"
                  },
                  "livemode": {
                    "type": "boolean",
                    "description": "Faux pour un événement d'une organisation bac à sable : données fictives, jamais une vraie analyse."
                  },
                  "timestamp": {
                    "type": "string",
                    "format": "date-time"
                  },
                  "data": {
                    "type": "object",
                    "required": [
                      "alert_id",
                      "client_id"
                    ],
                    "properties": {
                      "alert_id": {
                        "type": "string"
                      },
                      "client_id": {
                        "type": "string"
                      },
                      "case_id": {
                        "type": "string"
                      },
                      "client_external_ref": {
                        "type": "string",
                        "description": "La référence de votre application pour le client, quand elle en a défini une."
                      },
                      "case_external_ref": {
                        "type": "string",
                        "description": "La référence de votre application pour le dossier, quand l'événement concerne un dossier et qu'elle en a défini une."
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Toute réponse 2xx accuse réception de l'envoi ; toute autre est reprise."
          }
        }
      }
    },
    "alert.resolved": {
      "post": {
        "summary": "alert.resolved",
        "description": "Un membre a examiné une alerte. Signé selon Standard Webhooks : vérifiez `webhook-signature` avec le secret du point de réception, dédoublonnez sur `webhook-id`.",
        "operationId": "webhook.alert.resolved",
        "tags": [
          "Webhooks"
        ],
        "parameters": [
          {
            "name": "webhook-id",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "webhook-timestamp",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "webhook-signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "type",
                  "timestamp",
                  "livemode",
                  "data"
                ],
                "properties": {
                  "type": {
                    "const": "alert.resolved"
                  },
                  "livemode": {
                    "type": "boolean",
                    "description": "Faux pour un événement d'une organisation bac à sable : données fictives, jamais une vraie analyse."
                  },
                  "timestamp": {
                    "type": "string",
                    "format": "date-time"
                  },
                  "data": {
                    "type": "object",
                    "required": [
                      "alert_id",
                      "client_id"
                    ],
                    "properties": {
                      "alert_id": {
                        "type": "string"
                      },
                      "client_id": {
                        "type": "string"
                      },
                      "case_id": {
                        "type": "string"
                      },
                      "client_external_ref": {
                        "type": "string",
                        "description": "La référence de votre application pour le client, quand elle en a défini une."
                      },
                      "case_external_ref": {
                        "type": "string",
                        "description": "La référence de votre application pour le dossier, quand l'événement concerne un dossier et qu'elle en a défini une."
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Toute réponse 2xx accuse réception de l'envoi ; toute autre est reprise."
          }
        }
      }
    },
    "decision.pending": {
      "post": {
        "summary": "decision.pending",
        "description": "Une décision attend un membre : une revue de niveau après un changement de vigilance (`kind: level_review`) ou l'examen d'une alerte proposé par un assistant (`kind: alert_review_proposal`, avec `alert_id`). Seul un membre décide, dans LexOpti ou ses écrans embarqués. Signé selon Standard Webhooks : vérifiez `webhook-signature` avec le secret du point de réception, dédoublonnez sur `webhook-id`.",
        "operationId": "webhook.decision.pending",
        "tags": [
          "Webhooks"
        ],
        "parameters": [
          {
            "name": "webhook-id",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "webhook-timestamp",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "webhook-signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "type",
                  "timestamp",
                  "livemode",
                  "data"
                ],
                "properties": {
                  "type": {
                    "const": "decision.pending"
                  },
                  "livemode": {
                    "type": "boolean",
                    "description": "Faux pour un événement d'une organisation bac à sable : données fictives, jamais une vraie analyse."
                  },
                  "timestamp": {
                    "type": "string",
                    "format": "date-time"
                  },
                  "data": {
                    "type": "object",
                    "required": [
                      "kind",
                      "decision_id",
                      "client_id"
                    ],
                    "properties": {
                      "kind": {
                        "type": "string",
                        "enum": [
                          "level_review",
                          "alert_review_proposal"
                        ]
                      },
                      "decision_id": {
                        "type": "string"
                      },
                      "client_id": {
                        "type": "string"
                      },
                      "case_id": {
                        "type": "string"
                      },
                      "client_external_ref": {
                        "type": "string",
                        "description": "La référence de votre application pour le client, quand elle en a défini une."
                      },
                      "case_external_ref": {
                        "type": "string",
                        "description": "La référence de votre application pour le dossier, quand l'événement concerne un dossier et qu'elle en a défini une."
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Toute réponse 2xx accuse réception de l'envoi ; toute autre est reprise."
          }
        }
      }
    },
    "quota.exhausted": {
      "post": {
        "summary": "quota.exhausted",
        "description": "L'organisation a dépensé son dernier crédit : une analyse qui ouvre ou agrandit un dossier est refusée (`quota_exceeded`) jusqu'à une offre supérieure ou une recharge ; les lancements dans l'année payée d’un dossier et pour les personnes déjà comptées restent gratuits. Lisez `GET /v1/usage`. Signé selon Standard Webhooks : vérifiez `webhook-signature` avec le secret du point de réception, dédoublonnez sur `webhook-id`.",
        "operationId": "webhook.quota.exhausted",
        "tags": [
          "Webhooks"
        ],
        "parameters": [
          {
            "name": "webhook-id",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "webhook-timestamp",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "webhook-signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "type",
                  "timestamp",
                  "livemode",
                  "data"
                ],
                "properties": {
                  "type": {
                    "const": "quota.exhausted"
                  },
                  "livemode": {
                    "type": "boolean",
                    "description": "Faux pour un événement d'une organisation bac à sable : données fictives, jamais une vraie analyse."
                  },
                  "timestamp": {
                    "type": "string",
                    "format": "date-time"
                  },
                  "data": {
                    "type": "object",
                    "required": [],
                    "properties": {
                      "client_id": {
                        "type": "string"
                      },
                      "case_id": {
                        "type": "string"
                      },
                      "client_external_ref": {
                        "type": "string",
                        "description": "La référence de votre application pour le client, quand elle en a défini une."
                      },
                      "case_external_ref": {
                        "type": "string",
                        "description": "La référence de votre application pour le dossier, quand l'événement concerne un dossier et qu'elle en a défini une."
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Toute réponse 2xx accuse réception de l'envoi ; toute autre est reprise."
          }
        }
      }
    },
    "subscription.inactive": {
      "post": {
        "summary": "subscription.inactive",
        "description": "L'organisation n'est plus cliente (`reason`, le statut de son abonnement) : aucune offre ne court, ses crédits sont gelés, sa vigilance est en pause et les analyses sont refusées (`subscription_inactive`) jusqu'à un nouvel abonnement. Signé selon Standard Webhooks : vérifiez `webhook-signature` avec le secret du point de réception, dédoublonnez sur `webhook-id`.",
        "operationId": "webhook.subscription.inactive",
        "tags": [
          "Webhooks"
        ],
        "parameters": [
          {
            "name": "webhook-id",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "webhook-timestamp",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "webhook-signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "type",
                  "timestamp",
                  "livemode",
                  "data"
                ],
                "properties": {
                  "type": {
                    "const": "subscription.inactive"
                  },
                  "livemode": {
                    "type": "boolean",
                    "description": "Faux pour un événement d'une organisation bac à sable : données fictives, jamais une vraie analyse."
                  },
                  "timestamp": {
                    "type": "string",
                    "format": "date-time"
                  },
                  "data": {
                    "type": "object",
                    "required": [
                      "reason"
                    ],
                    "properties": {
                      "reason": {
                        "type": "string",
                        "enum": [
                          "trial_ended",
                          "expired",
                          "past_due",
                          "canceled",
                          "incomplete"
                        ]
                      },
                      "client_id": {
                        "type": "string"
                      },
                      "case_id": {
                        "type": "string"
                      },
                      "client_external_ref": {
                        "type": "string",
                        "description": "La référence de votre application pour le client, quand elle en a défini une."
                      },
                      "case_external_ref": {
                        "type": "string",
                        "description": "La référence de votre application pour le dossier, quand l'événement concerne un dossier et qu'elle en a défini une."
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Toute réponse 2xx accuse réception de l'envoi ; toute autre est reprise."
          }
        }
      }
    },
    "access.revoked": {
      "post": {
        "summary": "access.revoked",
        "description": "Votre application a perdu son accès à l'organisation (`reason`) : le dernier envoi au point de réception, qui est ensuite désactivé (`disabled_reason: access_revoked`). Envoyé à chaque point de réception de l'application dans l'organisation, quels que soient ses types d'événement ; jamais dans `GET /v1/events`. Signé selon Standard Webhooks : vérifiez `webhook-signature` avec le secret du point de réception, dédoublonnez sur `webhook-id`.",
        "operationId": "webhook.access.revoked",
        "tags": [
          "Webhooks"
        ],
        "parameters": [
          {
            "name": "webhook-id",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "webhook-timestamp",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "webhook-signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "type",
                  "timestamp",
                  "livemode",
                  "data"
                ],
                "properties": {
                  "type": {
                    "const": "access.revoked"
                  },
                  "livemode": {
                    "type": "boolean",
                    "description": "Faux pour un événement d'une organisation bac à sable : données fictives, jamais une vraie analyse."
                  },
                  "timestamp": {
                    "type": "string",
                    "format": "date-time"
                  },
                  "data": {
                    "type": "object",
                    "required": [
                      "reason"
                    ],
                    "properties": {
                      "reason": {
                        "type": "string",
                        "enum": [
                          "consent_revoked",
                          "blocked",
                          "application_disabled"
                        ]
                      },
                      "client_id": {
                        "type": "string"
                      },
                      "case_id": {
                        "type": "string"
                      },
                      "client_external_ref": {
                        "type": "string",
                        "description": "La référence de votre application pour le client, quand elle en a défini une."
                      },
                      "case_external_ref": {
                        "type": "string",
                        "description": "La référence de votre application pour le dossier, quand l'événement concerne un dossier et qu'elle en a défini une."
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Toute réponse 2xx accuse réception de l'envoi ; toute autre est reprise."
          }
        }
      }
    },
    "member.enrolled": {
      "post": {
        "summary": "member.enrolled",
        "description": "Un propriétaire ou un administrateur a enrôlé une personne de la structure par votre application (`POST /v1/members/enrolments`) : `status` vaut `pending` jusqu'à son premier code e-mail, ou `activated` aussitôt en mode délégué ([glossaire](https://developers.lexopti.com/fr/glossary/)) (alors avec `member_id`). Signé selon Standard Webhooks : vérifiez `webhook-signature` avec le secret du point de réception, dédoublonnez sur `webhook-id`.",
        "operationId": "webhook.member.enrolled",
        "tags": [
          "Webhooks"
        ],
        "parameters": [
          {
            "name": "webhook-id",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "webhook-timestamp",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "webhook-signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "type",
                  "timestamp",
                  "livemode",
                  "data"
                ],
                "properties": {
                  "type": {
                    "const": "member.enrolled"
                  },
                  "livemode": {
                    "type": "boolean",
                    "description": "Faux pour un événement d'une organisation bac à sable : données fictives, jamais une vraie analyse."
                  },
                  "timestamp": {
                    "type": "string",
                    "format": "date-time"
                  },
                  "data": {
                    "type": "object",
                    "required": [
                      "enrolment_id",
                      "role",
                      "status",
                      "member_id"
                    ],
                    "properties": {
                      "enrolment_id": {
                        "type": "string"
                      },
                      "role": {
                        "type": "string"
                      },
                      "status": {
                        "type": "string",
                        "enum": [
                          "completed",
                          "failed"
                        ]
                      },
                      "member_id": {
                        "type": "string"
                      },
                      "client_id": {
                        "type": "string"
                      },
                      "case_id": {
                        "type": "string"
                      },
                      "client_external_ref": {
                        "type": "string",
                        "description": "La référence de votre application pour le client, quand elle en a défini une."
                      },
                      "case_external_ref": {
                        "type": "string",
                        "description": "La référence de votre application pour le dossier, quand l'événement concerne un dossier et qu'elle en a défini une."
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Toute réponse 2xx accuse réception de l'envoi ; toute autre est reprise."
          }
        }
      }
    },
    "member.joined": {
      "post": {
        "summary": "member.joined",
        "description": "Une personne enrôlée est devenue membre de l'organisation : à son premier code e-mail, ou aussitôt en mode délégué ([glossaire](https://developers.lexopti.com/fr/glossary/)). `member_id` est son identifiant d'utilisateur, l'`id` de `GET /v1/members` ; `role` son rôle. Signé selon Standard Webhooks : vérifiez `webhook-signature` avec le secret du point de réception, dédoublonnez sur `webhook-id`.",
        "operationId": "webhook.member.joined",
        "tags": [
          "Webhooks"
        ],
        "parameters": [
          {
            "name": "webhook-id",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "webhook-timestamp",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "webhook-signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "type",
                  "timestamp",
                  "livemode",
                  "data"
                ],
                "properties": {
                  "type": {
                    "const": "member.joined"
                  },
                  "livemode": {
                    "type": "boolean",
                    "description": "Faux pour un événement d'une organisation bac à sable : données fictives, jamais une vraie analyse."
                  },
                  "timestamp": {
                    "type": "string",
                    "format": "date-time"
                  },
                  "data": {
                    "type": "object",
                    "required": [
                      "enrolment_id",
                      "member_id",
                      "role"
                    ],
                    "properties": {
                      "enrolment_id": {
                        "type": "string"
                      },
                      "member_id": {
                        "type": "string"
                      },
                      "role": {
                        "type": "string"
                      },
                      "client_id": {
                        "type": "string"
                      },
                      "case_id": {
                        "type": "string"
                      },
                      "client_external_ref": {
                        "type": "string",
                        "description": "La référence de votre application pour le client, quand elle en a défini une."
                      },
                      "case_external_ref": {
                        "type": "string",
                        "description": "La référence de votre application pour le dossier, quand l'événement concerne un dossier et qu'elle en a défini une."
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Toute réponse 2xx accuse réception de l'envoi ; toute autre est reprise."
          }
        }
      }
    }
  }
}
