# MARKO Developers

- [Développer avec MARKO](https://developers.marko.fr/index.md): Les guides et la référence pour intégrer l'API partenaire MARKO.
- [Premier appel](https://developers.marko.fr/quickstart.md): Créez un bearer puis listez les opérations accessibles à votre clé MARKO.
- [Authentification](https://developers.marko.fr/authentication.md): Signez l'échange HMAC-SHA256 et utilisez le bearer renvoyé par MARKO.
- [Comprendre les ressources](https://developers.marko.fr/concepts.md): Les liens entre entité, fonds, SPV, opérations et documents, et les identifiants à conserver.
- [Ressources de l'API](https://developers.marko.fr/resources.md): Trouver les familles métier et choisir les routes utiles à votre intégration.
- [Synchroniser une opération depuis un CRM](https://developers.marko.fr/tutorials/crm-sync.md): Créer ou mettre à jour une opération, conserver son UUID et importer une note historique.
- [Importer un lot et traiter ses résultats](https://developers.marko.fr/tutorials/batch-import.md): Envoyer un lot, suivre le job, paginer ses résultats et choisir la bonne reprise.
- [Envoyer un document et suivre son extraction](https://developers.marko.fr/tutorials/document-extraction.md): Uploader un fichier dans une opération existante, vérifier sa fiche et suivre le job IA.
- [Exemples Python, Node.js et PHP](https://developers.marko.fr/code-examples.md): Des programmes sans dépendances pour signer l'échange HMAC et appeler les routes JSON.
- [Environnements](https://developers.marko.fr/environments.md): Distinguez les hôtes de préproduction et production des clés sandbox et live.
- [Scopes et délégation](https://developers.marko.fr/scopes-and-delegation.md): Choisir les droits de l'intégration et appeler les routes d'un utilisateur délégué.
- [Pagination et données](https://developers.marko.fr/pagination-and-data.md): Lire toutes les pages, utiliser les filtres exacts et interpréter les types métier.
- [Écritures et idempotence](https://developers.marko.fr/writes-and-idempotency.md): Synchroniser des ressources sans doublons et reprendre une écriture après une réponse incertaine.
- [Erreurs et reprises](https://developers.marko.fr/errors-and-retries.md): Interprétez les erreurs HTTP et utilisez les clés d'idempotence sur les écritures concernées.
- [Imports et notes](https://developers.marko.fr/imports-and-notes.md): Importer un lot durable, suivre chaque élément et préserver les dates historiques des notes.
- [Documents et upload](https://developers.marko.fr/documents-guide.md): Transmettre un fichier, comprendre la déclaration metadata et vérifier le document obtenu.
- [Taxonomies](https://developers.marko.fr/taxonomies-guide.md): Utiliser les codes visibles de l'entité et gérer les options créées par les imports externes.
- [Workflows et extraction IA](https://developers.marko.fr/workflows-guide.md): Distinguer définitions, exécutions, recommandations et jobs d'analyse documentaire.
- [Données personnelles et RGPD](https://developers.marko.fr/privacy-guide.md): Comprendre les exports délégués, leur couverture et les résultats d'effacement durables.
- [IA et outils de développement](https://developers.marko.fr/ai-and-tools.md): Copier une page ou toute la documentation, récupérer OpenAPI et générer un client.
- [Historique de la documentation](https://developers.marko.fr/changelog.md): Suivre les changements de référence et savoir à quelle version de l'API ils se rapportent.
- [Obtenir un bearer court](https://developers.marko.fr/api-reference/auth/obtenir-un-bearer-court.md): Echange une cle API brute contre un bearer MARKO court. La signature HMAC-SHA256 est calculee avec la cle API brute sur le message canonique `MARKO-EXTERNAL-API-TOKEN-V1\n{key_id}\n{timestamp}\n{nonce}`. Utilisez ensuite `Authorization: Bearer YOUR_BEARER_HERE` sur les endpoints metier.
- [Recuperer la fiche de l'entite](https://developers.marko.fr/api-reference/entity/recuperer-la-fiche-de-lentite.md): Expose l'entite rattachee a la cle API, sans changer de contexte.
- [Recuperer la synthese portefeuille](https://developers.marko.fr/api-reference/portfolio/recuperer-la-synthese-portefeuille.md): Retourne un resume portefeuille agrege pour l'entite de la cle, sans parametre de filtre. Les totaux excluent les ressources supprimees et les repartitions utilisent les codes de taxonomie effectifs.
- [Lister les deals](https://developers.marko.fr/api-reference/deals/lister-les-deals.md): Expose le pipeline CRM pre-closing de l'entité.
- [Créer un deal](https://developers.marko.fr/api-reference/deals/créer-un-deal.md): Crée un deal dans le pipeline pre-closing.
- [Récupérer un deal](https://developers.marko.fr/api-reference/deals/récupérer-un-deal.md): Retourne un deal unitaire du pipeline.
- [Mettre à jour un deal](https://developers.marko.fr/api-reference/deals/mettre-à-jour-un-deal.md): Met à jour un deal existant du pipeline.
- [Supprimer un deal](https://developers.marko.fr/api-reference/deals/supprimer-un-deal.md): Supprime logiquement un deal du pipeline.
- [Lister les notes d'un deal](https://developers.marko.fr/api-reference/deals/lister-les-notes-dun-deal.md): Expose les notes attachées à un deal.
- [Créer une note de deal](https://developers.marko.fr/api-reference/deals/créer-une-note-de-deal.md): Ajoute une note sur un deal du pipeline.
- [Supprimer une note de deal](https://developers.marko.fr/api-reference/deals/supprimer-une-note-de-deal.md): Supprime une note rattachée au pipeline deals.
- [Lister les fonds](https://developers.marko.fr/api-reference/fonds/lister-les-fonds.md): Retourne les fonds visibles pour l'entite de la cle, par page bornee. Les en-tetes X-Marko-Limit, X-Marko-Offset et X-Marko-Has-More decrivent la page.
- [Créer un fonds](https://developers.marko.fr/api-reference/fonds/créer-un-fonds.md): Crée un fonds d'investissement dans l'entité.
- [Récupérer un fonds](https://developers.marko.fr/api-reference/fonds/récupérer-un-fonds.md): Retourne le détail d'un fonds MARKO.
- [Mettre à jour un fonds](https://developers.marko.fr/api-reference/fonds/mettre-à-jour-un-fonds.md): Met à jour les métadonnées d'un fonds.
- [Supprimer un fonds](https://developers.marko.fr/api-reference/fonds/supprimer-un-fonds.md): Supprime logiquement un fonds.
- [Lister les SPV](https://developers.marko.fr/api-reference/spvs/lister-les-spv.md): Permet de rechercher un SPV par nom exact insensible a la casse via `name`, et de filtrer par fonds via `fond_id`. Le filtre par nom est un controle avant creation, pas une garantie d'unicite concurrente; conservez l'identifiant MARKO et utilisez Idempotency-Key pour les ecritures. Les en-tetes X-Ma…
- [Créer une SPV](https://developers.marko.fr/api-reference/spvs/créer-une-spv.md): Crée une SPV sur l'entité et le fonds ciblé. La forme juridique, le SIREN et l'adresse peuvent etre fournis des la creation. Le type d'investissement reste porte par l'operation, car une meme SPV peut en regrouper plusieurs.
- [Récupérer une SPV par identifiant externe](https://developers.marko.fr/api-reference/spvs/récupérer-une-spv-par-identifiant-externe.md): Résout l'identifiant stable du partenaire vers la SPV MARKO.
- [Créer ou mettre à jour une SPV externe](https://developers.marko.fr/api-reference/spvs/créer-ou-mettre-à-jour-une-spv-externe.md): Upsert synchrone par identifiant partenaire. Une ressource MARKO supprimée logiquement est restaurée avec le même UUID. existing_marko_id permet de lier explicitement une SPV existante lors du premier envoi.
- [Récupérer une SPV](https://developers.marko.fr/api-reference/spvs/récupérer-une-spv.md): Retourne le détail d'une SPV MARKO.
- [Mettre à jour une SPV](https://developers.marko.fr/api-reference/spvs/mettre-à-jour-une-spv.md): Met à jour les attributs d'une SPV.
- [Supprimer une SPV](https://developers.marko.fr/api-reference/spvs/supprimer-une-spv.md): Supprime logiquement une SPV.
- [Lister les operations](https://developers.marko.fr/api-reference/operations/lister-les-operations.md): Supporte la recherche par nom exact insensible a la casse, la pagination, le filtrage par statut et le filtrage par SPV. Le filtre par nom est un controle avant creation, pas une garantie d'unicite concurrente; conservez l'identifiant MARKO et utilisez external_id avec Idempotency-Key.
- [Recuperer une operation](https://developers.marko.fr/api-reference/operations/recuperer-une-operation.md): Retourne le detail d'une operation par son identifiant MARKO.
- [Supprimer une opération](https://developers.marko.fr/api-reference/operations/supprimer-une-opération.md): Supprime logiquement une opération existante.
- [Récupérer une opération par identifiant externe](https://developers.marko.fr/api-reference/operations/récupérer-une-opération-par-identifiant-externe.md): Résout l'identifiant stable du système partenaire et retourne immédiatement l'identifiant MARKO et la ressource courante. Les codes `custom__...` sont générés par MARKO : conservez toujours le code renvoyé au lieu de le construire.
- [Creer ou mettre a jour une operation externe](https://developers.marko.fr/api-reference/operations/creer-ou-mettre-a-jour-une-operation-externe.md): Crée ou met à jour immédiatement une opération à partir d'un identifiant partenaire stable. La réponse contient directement marko_id. Une valeur de taxonomie inconnue est créée pour l'entité, visible immédiatement et signalée dans taxonomy_additions. Le segment généré des codes `custom__...` n'est p…
- [Lister le socle canonique MARKO historique](https://developers.marko.fr/api-reference/operations/lister-le-socle-canonique-marko-historique.md): Endpoint legacy: retourne uniquement le socle canonique MARKO historique. Les écritures acceptent aussi les valeurs propres à l'entité. Utilisez `GET /v1/taxonomies?dimension=...` pour la liste visible et autoritative, y compris les options ClubFunding.
- [Importer un lot d'operations externes](https://developers.marko.fr/api-reference/operations/importer-un-lot-doperations-externes.md): Accepte jusqu'à 500 opérations, 10 000 notes et 20 Mio par requête. Le job est durable et chaque élément possède son propre résultat. `category` dans les notes est une chaine libre de 1 a 80 caracteres.
- [Récupérer un suivi par identifiants externes](https://developers.marko.fr/api-reference/operations/récupérer-un-suivi-par-identifiants-externes.md): Retourne la note uniquement si elle appartient à l'opération externe indiquée.
- [Importer une note de suivi externe](https://developers.marko.fr/api-reference/operations/importer-une-note-de-suivi-externe.md): Crée ou met à jour immédiatement une note historique datée sur une opération référencée par son identifiant externe. La réponse contient directement son marko_id. Une catégorie inconnue devient une option d'entité visible, avec la source partenaire. Une mise à jour versionnée doit porter un source_u…
- [Lister les notes de suivi MARKO](https://developers.marko.fr/api-reference/operations/lister-les-notes-de-suivi-marko.md): Retourne les notes triées par date métier avec texte et catégorie libre.
- [Créer une note de suivi MARKO](https://developers.marko.fr/api-reference/operations/créer-une-note-de-suivi-marko.md): Crée une note sans identifiant externe; pour un import idempotent, utilisez la route notes/external. `category` est une chaine libre de 1 a 80 caracteres; valeurs conseillees: call, comite, juridique ou libre.
- [Lire l'historique technique d'une opération](https://developers.marko.fr/api-reference/operations/lire-lhistorique-technique-dune-opération.md): Historique paginé des transitions, changements de champs et événements d'audit.
- [Lire la chronologie narrative d'une opération](https://developers.marko.fr/api-reference/operations/lire-la-chronologie-narrative-dune-opération.md): Agrège notamment les notes de suivi. Pour une note importée, metadata expose note_date, note_text et note_category.
- [Lister l'historique de remboursements](https://developers.marko.fr/api-reference/operations/lister-lhistorique-de-remboursements.md): Retourne les remboursements saisis sur une opération avec pagination.
- [Créer un remboursement](https://developers.marko.fr/api-reference/operations/créer-un-remboursement.md): Enregistre un remboursement sur une opération.
- [Lister une taxonomie d'entité](https://developers.marko.fr/api-reference/taxonomies/lister-une-taxonomie-dentité.md): Retourne les options visibles décidées par l'administrateur de l'entité. Une option courante masquée peut être demandée avec current_code afin de rester affichable sans être proposée pour une nouvelle sélection.
- [Suivre un job d'import](https://developers.marko.fr/api-reference/import-jobs/suivre-un-job-dimport.md): Retourne les compteurs completed, noop, failed et conflict du job durable. Pour un import d'une operation, `operation_id` est renseigne des que la cible MARKO existe; sinon `error_code` et `error_message` decrivent l'echec.
- [Lister les résultats d'un import](https://developers.marko.fr/api-reference/import-jobs/lister-les-résultats-dun-import.md): Filtre les résultats par `status` ou `item_kind` pour diagnostiquer et reprendre un lot.
- [Relancer les éléments échoués](https://developers.marko.fr/api-reference/import-jobs/relancer-les-éléments-échoués.md): Réenfile un job failed ou partial; les éléments déjà terminés restent des no-op.
- [Demander l'arrêt d'un import](https://developers.marko.fr/api-reference/import-jobs/demander-larrêt-dun-import.md): Demande un arrêt propre au prochain point de reprise durable.
- [Modifier une note de suivi](https://developers.marko.fr/api-reference/comments/modifier-une-note-de-suivi.md): Modifie la date métier, le texte ou la catégorie d'une note MARKO.
- [Supprimer une note de suivi](https://developers.marko.fr/api-reference/comments/supprimer-une-note-de-suivi.md): Supprime la note; l'événement de suppression reste dans la chronologie.
- [Lister les documents](https://developers.marko.fr/api-reference/documents/lister-les-documents.md): Peut filtrer sur une operation MARKO ou une `operation_external_id`.
- [Recuperer un document](https://developers.marko.fr/api-reference/documents/recuperer-un-document.md): Retourne le metadata d'un document et son URL de telechargement si disponible.
- [Mettre à jour un document](https://developers.marko.fr/api-reference/documents/mettre-à-jour-un-document.md): Met à jour les métadonnées d'un document existant.
- [Supprimer un document](https://developers.marko.fr/api-reference/documents/supprimer-un-document.md): Supprime logiquement un document existant.
- [Rattacher un document à une opération](https://developers.marko.fr/api-reference/documents/rattacher-un-document-à-une-opération.md): Rattache atomiquement un document non affecté à une opération MARKO. Une relance avec la même clé d'idempotence rejoue la première réponse; une nouvelle intention échoue si le document est déjà rattaché.
- [Creer le metadata d'un document](https://developers.marko.fr/api-reference/documents/creer-le-metadata-dun-document.md): Route idempotente pour declarer un document avant upload physique.
- [Uploader un document](https://developers.marko.fr/api-reference/documents/uploader-un-document.md): Upload multipart/form-data idempotent avec rattachement a une operation via `operation_id` ou `operation_external_id`.
- [Lister les utilisateurs de l'entité](https://developers.marko.fr/api-reference/users/lister-les-utilisateurs-de-lentité.md): Expose les utilisateurs Better Auth rattachés à l'entité de la clé.
- [Inviter un utilisateur](https://developers.marko.fr/api-reference/users/inviter-un-utilisateur.md): Crée un utilisateur d'entité et déclenche le flux d'activation Better Auth.
- [Mettre à jour un utilisateur](https://developers.marko.fr/api-reference/users/mettre-à-jour-un-utilisateur.md): Met à jour le rôle d'un utilisateur de l'entité.
- [Retirer un utilisateur](https://developers.marko.fr/api-reference/users/retirer-un-utilisateur.md): Annule immédiatement une invitation non activée ou retire les accès d'un compte actif et lance son workflow durable d'effacement RGPD.
- [Suspendre un utilisateur](https://developers.marko.fr/api-reference/users/suspendre-un-utilisateur.md): Suspend un utilisateur activé de l'entité.
- [Réactiver un utilisateur](https://developers.marko.fr/api-reference/users/réactiver-un-utilisateur.md): Réactive un utilisateur suspendu.
- [Renvoyer une invitation](https://developers.marko.fr/api-reference/users/renvoyer-une-invitation.md): Régénère le flux d'activation pour un utilisateur non activé.
- [Déclencher un reset mot de passe](https://developers.marko.fr/api-reference/users/déclencher-un-reset-mot-de-passe.md): Déclenche le flux Better Auth de reset ou réactivation.
- [Lire le profil d'un utilisateur délégué](https://developers.marko.fr/api-reference/users/lire-le-profil-dun-utilisateur-délégué.md): Nécessite exactement un header `X-Marko-Delegated-User-Id` ou `X-Marko-Delegated-User-Email` pour résoudre le sujet utilisateur dans la même entité.
- [Mettre à jour le profil d'un utilisateur délégué](https://developers.marko.fr/api-reference/users/mettre-à-jour-le-profil-dun-utilisateur-délégué.md): Met à jour le profil du sujet utilisateur délégué résolu via header.
- [Lire les préférences d'un utilisateur délégué](https://developers.marko.fr/api-reference/users/lire-les-préférences-dun-utilisateur-délégué.md): Retourne les préférences du sujet utilisateur délégué résolu via header.
- [Mettre à jour les préférences d'un utilisateur délégué](https://developers.marko.fr/api-reference/users/mettre-à-jour-les-préférences-dun-utilisateur-délégué.md): Met à jour les préférences du sujet utilisateur délégué résolu via header.
- [Lire les préférences d'alerte d'un utilisateur délégué](https://developers.marko.fr/api-reference/users/lire-les-préférences-dalerte-dun-utilisateur-délégué.md): Retourne les préférences d'alerte du sujet utilisateur délégué résolu via header.
- [Mettre à jour les préférences d'alerte d'un utilisateur délégué](https://developers.marko.fr/api-reference/users/mettre-à-jour-les-préférences-dalerte-dun-utilisateur-délégué.md): Met à jour les préférences d'alerte du sujet utilisateur délégué résolu via header.
- [Lister les vues sauvegardées du sujet délégué](https://developers.marko.fr/api-reference/users/lister-les-vues-sauvegardées-du-sujet-délégué.md): Exige un sujet utilisateur délégué résolu via header, une allowlist explicite sur la clé, et la capacité `saved_views`.
- [Créer une vue sauvegardée pour le sujet délégué](https://developers.marko.fr/api-reference/users/créer-une-vue-sauvegardée-pour-le-sujet-délégué.md): Exige une allowlist explicite sur la clé et la capacité `saved_views`.
- [Lire une vue sauvegardée du sujet délégué](https://developers.marko.fr/api-reference/users/lire-une-vue-sauvegardée-du-sujet-délégué.md): Retourne une vue sauvegardée possédée par le sujet utilisateur délégué.
- [Mettre à jour une vue sauvegardée du sujet délégué](https://developers.marko.fr/api-reference/users/mettre-à-jour-une-vue-sauvegardée-du-sujet-délégué.md): Exige une allowlist explicite sur la clé et la capacité `saved_views`.
- [Supprimer une vue sauvegardée du sujet délégué](https://developers.marko.fr/api-reference/users/supprimer-une-vue-sauvegardée-du-sujet-délégué.md): Exige une allowlist explicite sur la clé et la capacité `saved_views`.
- [Lister les dashboards personnalisés du sujet délégué](https://developers.marko.fr/api-reference/users/lister-les-dashboards-personnalisés-du-sujet-délégué.md): Exige une allowlist explicite sur la clé et la capacité `custom_dashboards`.
- [Créer un dashboard personnalisé pour le sujet délégué](https://developers.marko.fr/api-reference/users/créer-un-dashboard-personnalisé-pour-le-sujet-délégué.md): Exige une allowlist explicite sur la clé et la capacité `custom_dashboards`.
- [Lire un dashboard personnalisé du sujet délégué](https://developers.marko.fr/api-reference/users/lire-un-dashboard-personnalisé-du-sujet-délégué.md): Retourne un dashboard possédé par le sujet utilisateur délégué.
- [Mettre à jour un dashboard personnalisé du sujet délégué](https://developers.marko.fr/api-reference/users/mettre-à-jour-un-dashboard-personnalisé-du-sujet-délégué.md): Exige une allowlist explicite sur la clé et la capacité `custom_dashboards`.
- [Supprimer un dashboard personnalisé du sujet délégué](https://developers.marko.fr/api-reference/users/supprimer-un-dashboard-personnalisé-du-sujet-délégué.md): Exige une allowlist explicite sur la clé et la capacité `custom_dashboards`.
- [Exporter les données personnelles du sujet délégué](https://developers.marko.fr/api-reference/users/exporter-les-données-personnelles-du-sujet-délégué.md): Exige une allowlist explicite sur la clé et la capacité `rgpd_export`.
- [Lister l'inventaire RGPD du sujet délégué](https://developers.marko.fr/api-reference/users/lister-linventaire-rgpd-du-sujet-délégué.md): Exige une allowlist explicite sur la clé et la capacité `rgpd_inventory`.
- [Exercer le droit à l'effacement pour le sujet délégué](https://developers.marko.fr/api-reference/users/exercer-le-droit-à-leffacement-pour-le-sujet-délégué.md): Exige une allowlist explicite sur la clé et la capacité `rgpd_erasure`, avec `{"confirm": true}`.
- [Lire les paramètres de l'entité](https://developers.marko.fr/api-reference/settings/lire-les-paramètres-de-lentité.md): Expose les paramètres métier et branding de l'entité.
- [Mettre à jour les paramètres de l'entité](https://developers.marko.fr/api-reference/settings/mettre-à-jour-les-paramètres-de-lentité.md): Met à jour les paramètres de reporting et de branding de l'entité.
- [Synthèse RCCI](https://developers.marko.fr/api-reference/rcci/synthèse-rcci.md): Agrège les covenants en tension, les documents manquants et les opérations à risque de l'entité.
- [Lister le dictionnaire de champs](https://developers.marko.fr/api-reference/field-definitions/lister-le-dictionnaire-de-champs.md): Expose le référentiel métier des champs MARKO avec filtres et pagination.
- [Récupérer une définition de champ par clé](https://developers.marko.fr/api-reference/field-definitions/récupérer-une-définition-de-champ-par-clé.md): Retourne la définition détaillée d'un champ métier par field_key.
- [Récupérer une définition de champ](https://developers.marko.fr/api-reference/field-definitions/récupérer-une-définition-de-champ.md): Retourne la définition détaillée d'un champ métier par identifiant.
- [Recherche globale](https://developers.marko.fr/api-reference/search/recherche-globale.md): Recherche transversale sur operations, operateurs, SPV, fonds et documents.
- [Recherche plein texte documentaire](https://developers.marko.fr/api-reference/search/recherche-plein-texte-documentaire.md): Recherche full-text dans le contenu documentaire indexé.
- [Lister les opérateurs](https://developers.marko.fr/api-reference/operateurs/lister-les-opérateurs.md): Expose les opérateurs et leurs métadonnées principales. Utilisez `name` pour une correspondance exacte insensible à la casse ou `search` pour une recherche partielle; ces filtres sont mutuellement exclusifs.
- [Créer un opérateur](https://developers.marko.fr/api-reference/operateurs/créer-un-opérateur.md): Crée un opérateur dans l'entité.
- [Récupérer un opérateur par identifiant externe](https://developers.marko.fr/api-reference/operateurs/récupérer-un-opérateur-par-identifiant-externe.md): Résout l'identifiant stable du partenaire vers l'opérateur MARKO.
- [Créer ou mettre à jour un opérateur externe](https://developers.marko.fr/api-reference/operateurs/créer-ou-mettre-à-jour-un-opérateur-externe.md): Upsert synchrone par identifiant partenaire, sans exiger de SIREN. Une ressource supprimée logiquement est restaurée avec le même UUID; existing_marko_id lie explicitement une cible existante lors du premier envoi.
- [Récupérer un opérateur](https://developers.marko.fr/api-reference/operateurs/récupérer-un-opérateur.md): Retourne le détail d'un opérateur.
- [Mettre à jour un opérateur](https://developers.marko.fr/api-reference/operateurs/mettre-à-jour-un-opérateur.md): Met à jour l'identité ou les données d'un opérateur.
- [Supprimer un opérateur](https://developers.marko.fr/api-reference/operateurs/supprimer-un-opérateur.md): Supprime logiquement un opérateur.
- [Lister les risques tiers d'un opérateur](https://developers.marko.fr/api-reference/operateurs/lister-les-risques-tiers-dun-opérateur.md): Expose les événements de surveillance tiers rattachés à un opérateur.
- [Créer un événement de risque tiers](https://developers.marko.fr/api-reference/operateurs/créer-un-événement-de-risque-tiers.md): Ajoute manuellement un événement de risque tiers pour un opérateur.
- [Résumé des risques tiers](https://developers.marko.fr/api-reference/operateurs/résumé-des-risques-tiers.md): Retourne le score de risque tiers et les compteurs agrégés d'un opérateur.
- [Résoudre un risque tiers](https://developers.marko.fr/api-reference/operateurs/résoudre-un-risque-tiers.md): Marque un événement tiers comme résolu.
- [Lister les alertes](https://developers.marko.fr/api-reference/alerts/lister-les-alertes.md): Expose la projection alertes de l'entité avec filtres.
- [Récupérer une alerte](https://developers.marko.fr/api-reference/alerts/récupérer-une-alerte.md): Retourne une alerte unitaire.
- [Accuser réception d'une alerte](https://developers.marko.fr/api-reference/alerts/accuser-réception-dune-alerte.md): Passe l'alerte au statut acknowledged.
- [Résoudre une alerte](https://developers.marko.fr/api-reference/alerts/résoudre-une-alerte.md): Passe l'alerte au statut resolved.
- [Mettre une alerte en snooze](https://developers.marko.fr/api-reference/alerts/mettre-une-alerte-en-snooze.md): Snooze une alerte pour quelques jours.
- [Lister les notifications](https://developers.marko.fr/api-reference/notifications/lister-les-notifications.md): Expose les notifications de l'entité.
- [Créer une notification](https://developers.marko.fr/api-reference/notifications/créer-une-notification.md): Crée une notification ciblée dans l'entité.
- [Compter les notifications non lues](https://developers.marko.fr/api-reference/notifications/compter-les-notifications-non-lues.md): Retourne le compteur unread et le flag critique.
- [Récupérer une notification](https://developers.marko.fr/api-reference/notifications/récupérer-une-notification.md): Retourne une notification unitaire.
- [Supprimer une notification](https://developers.marko.fr/api-reference/notifications/supprimer-une-notification.md): Supprime une notification de l'entité.
- [Marquer une notification comme lue](https://developers.marko.fr/api-reference/notifications/marquer-une-notification-comme-lue.md): Passe le drapeau read à true.
- [Marquer tout comme lu](https://developers.marko.fr/api-reference/notifications/marquer-tout-comme-lu.md): Marque toutes les notifications comme lues.
- [Qualifier un faux positif](https://developers.marko.fr/api-reference/notifications/qualifier-un-faux-positif.md): Marque une notification comme faux positif sans la supprimer.
- [Lister les événements calendrier](https://developers.marko.fr/api-reference/calendar/lister-les-événements-calendrier.md): Expose les échéances et événements persistés de l'entité.
- [Créer un événement calendrier](https://developers.marko.fr/api-reference/calendar/créer-un-événement-calendrier.md): Crée un événement manuel ou IA persisté.
- [Récupérer un événement calendrier](https://developers.marko.fr/api-reference/calendar/récupérer-un-événement-calendrier.md): Retourne un événement calendrier unitaire.
- [Mettre à jour un événement calendrier](https://developers.marko.fr/api-reference/calendar/mettre-à-jour-un-événement-calendrier.md): Met à jour un événement calendrier.
- [Supprimer un événement calendrier](https://developers.marko.fr/api-reference/calendar/supprimer-un-événement-calendrier.md): Supprime un événement calendrier.
- [Accepter un événement IA](https://developers.marko.fr/api-reference/calendar/accepter-un-événement-ia.md): Accepte un événement proposé.
- [Rejeter un événement IA](https://developers.marko.fr/api-reference/calendar/rejeter-un-événement-ia.md): Rejette un événement proposé.
- [Lire les données société locales par SIREN](https://developers.marko.fr/api-reference/enrichment/lire-les-données-société-locales-par-siren.md): Retourne uniquement les données déjà en cache ou présentes dans la base locale. Cet endpoint de lecture ne déclenche aucun appel facturable.
- [Résoudre une société par SIREN via Pappers](https://developers.marko.fr/api-reference/enrichment/résoudre-une-société-par-siren-via-pappers.md): Résout d'abord les données locales puis réserve de façon idempotente tout appel Pappers facturable. Requiert le header Idempotency-Key.
- [Valider un SIREN](https://developers.marko.fr/api-reference/enrichment/valider-un-siren.md): Vérifie le format et le checksum Luhn d'un SIREN sans appeler un provider externe.
- [Invalider le cache SIREN](https://developers.marko.fr/api-reference/enrichment/invalider-le-cache-siren.md): Supprime l'entrée de cache. Une nouvelle résolution provider exige ensuite POST /v1/enrichment/siren/{siren}/resolve.
- [Exporter le reporting INREV](https://developers.marko.fr/api-reference/reports/exporter-le-reporting-inrev.md): Génère le classeur INREV standard de l'entité au format XLSX.
- [Lister les templates de reporting](https://developers.marko.fr/api-reference/reporting/lister-les-templates-de-reporting.md): Expose les templates de reporting configurés pour l'entité.
- [Créer un template de reporting](https://developers.marko.fr/api-reference/reporting/créer-un-template-de-reporting.md): Crée un template de reporting personnalisé.
- [Récupérer un template de reporting](https://developers.marko.fr/api-reference/reporting/récupérer-un-template-de-reporting.md): Retourne le détail d'un template de reporting.
- [Mettre à jour un template de reporting](https://developers.marko.fr/api-reference/reporting/mettre-à-jour-un-template-de-reporting.md): Met à jour un template existant.
- [Supprimer un template de reporting](https://developers.marko.fr/api-reference/reporting/supprimer-un-template-de-reporting.md): Supprime un template de reporting non système.
- [Prévisualiser un template de reporting](https://developers.marko.fr/api-reference/reporting/prévisualiser-un-template-de-reporting.md): Retourne un aperçu tabulaire d'un template.
- [Lister les presets de workflows](https://developers.marko.fr/api-reference/workflows/lister-les-presets-de-workflows.md): Expose les presets d'automatisation supportés.
- [Lister les workflows](https://developers.marko.fr/api-reference/workflows/lister-les-workflows.md): Expose les automatisations système et personnalisées de l'entité.
- [Activer ou désactiver un workflow](https://developers.marko.fr/api-reference/workflows/activer-ou-désactiver-un-workflow.md): Bascule l'état d'un workflow système ou personnalisé.
- [Créer un workflow personnalisé](https://developers.marko.fr/api-reference/workflows/créer-un-workflow-personnalisé.md): Crée une définition de workflow personnalisée.
- [Mettre à jour un workflow personnalisé](https://developers.marko.fr/api-reference/workflows/mettre-à-jour-un-workflow-personnalisé.md): Met à jour une définition de workflow personnalisée.
- [Supprimer un workflow personnalisé](https://developers.marko.fr/api-reference/workflows/supprimer-un-workflow-personnalisé.md): Supprime une définition de workflow personnalisée.
- [Lancer un workflow maintenant](https://developers.marko.fr/api-reference/workflows/lancer-un-workflow-maintenant.md): Déclenche une exécution manuelle d'un workflow personnalisé.
- [Lister les jobs AI extraction](https://developers.marko.fr/api-reference/workflows/lister-les-jobs-ai-extraction.md): Expose les jobs d'extraction IA de l'entité.
- [Créer un job AI extraction](https://developers.marko.fr/api-reference/workflows/créer-un-job-ai-extraction.md): Place un job d'extraction IA dans la file gouvernée pour un document.
- [Récupérer un job AI extraction](https://developers.marko.fr/api-reference/workflows/récupérer-un-job-ai-extraction.md): Retourne le détail d'un job d'extraction IA.
- [Lister l'historique workflows](https://developers.marko.fr/api-reference/workflows/lister-lhistorique-workflows.md): Expose l'historique d'exécution des jobs et workflows.
- [Statistiques workflows](https://developers.marko.fr/api-reference/workflows/statistiques-workflows.md): Expose un résumé des exécutions workflows.
- [Lister les recommandations d'automatisation](https://developers.marko.fr/api-reference/workflows/lister-les-recommandations-dautomatisation.md): Expose les recommandations d'automatisation calculées pour l'entité.
- [Prévisualiser les recommandations d'automatisation](https://developers.marko.fr/api-reference/workflows/prévisualiser-les-recommandations-dautomatisation.md): Calcule une vue de recommandations sans persister d'état serveur.
- [Préparer une recommandation pour décision](https://developers.marko.fr/api-reference/workflows/préparer-une-recommandation-pour-décision.md): Persiste une seule recommandation prévisualisée avant acceptation, report ou rejet.
- [Accepter une recommandation](https://developers.marko.fr/api-reference/workflows/accepter-une-recommandation.md): Acquitte une recommandation d'automatisation côté entité.
- [Rejeter une recommandation](https://developers.marko.fr/api-reference/workflows/rejeter-une-recommandation.md): Classe une recommandation comme non pertinente.
- [Reporter une recommandation](https://developers.marko.fr/api-reference/workflows/reporter-une-recommandation.md): Snooze une recommandation pendant quelques jours ou jusqu'à une date donnée.
- [Créer un workflow depuis une recommandation](https://developers.marko.fr/api-reference/workflows/créer-un-workflow-depuis-une-recommandation.md): Instancie un workflow personnalisé prérempli à partir d'une recommandation validée.
- [Lister les tâches agrégées](https://developers.marko.fr/api-reference/tasks/lister-les-tâches-agrégées.md): Expose les tâches Kanban agrégées de l'entité.
- [Lister les tâches d'une opération](https://developers.marko.fr/api-reference/tasks/lister-les-tâches-dune-opération.md): Expose les tâches Kanban d'une opération donnée.
- [Créer une tâche](https://developers.marko.fr/api-reference/tasks/créer-une-tâche.md): Crée une tâche Kanban pour une opération.
- [Récupérer une tâche](https://developers.marko.fr/api-reference/tasks/récupérer-une-tâche.md): Retourne une tâche Kanban unitaire.
- [Mettre à jour une tâche](https://developers.marko.fr/api-reference/tasks/mettre-à-jour-une-tâche.md): Met à jour une tâche Kanban.
- [Archiver une tâche](https://developers.marko.fr/api-reference/tasks/archiver-une-tâche.md): Archive une tâche Kanban.
- [Réordonner une tâche](https://developers.marko.fr/api-reference/tasks/réordonner-une-tâche.md): Déplace une tâche dans le board Kanban.
- [Lister les labels de tâches](https://developers.marko.fr/api-reference/tasks/lister-les-labels-de-tâches.md): Expose les labels Kanban disponibles.
- [Créer un label de tâche](https://developers.marko.fr/api-reference/tasks/créer-un-label-de-tâche.md): Crée un label Kanban.
- [Supprimer un label de tâche](https://developers.marko.fr/api-reference/tasks/supprimer-un-label-de-tâche.md): Supprime un label Kanban.

## OpenAPI Specs

- [openapi](/openapi.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.