# Référence des outils MCP

- [Référence des outils MCP](https://sosoapi.ai/fr/docs/mcp): Retrouvez les entrées, sorties, profils et disponibilités locales ou hébergées des outils.
- [Obtenir le profil utilisateur](https://sosoapi.ai/fr/docs/mcp/get-user-profile): MCP: Obtenir le profil utilisateur. Lire le profil de l’utilisateur connecté (nom affiché, fuseau horaire, avatar, thème) ; profile vaut null tant qu’il n’existe pas.
- [Mettre à jour le profil utilisateur](https://sosoapi.ai/fr/docs/mcp/update-user-profile): MCP: Mettre à jour le profil utilisateur. Modifier le profil de l’utilisateur connecté (display_name, timezone, avatar_url, theme). Envoyer uniquement les champs à modifier.
- [Signer le téléversement d’un avatar](https://sosoapi.ai/fr/docs/mcp/sign-avatar-upload): MCP: Signer le téléversement d’un avatar. Obtenir une URL signée pour téléverser une nouvelle image d’avatar pour l’utilisateur connecté (filename et content_type requis). Cela ne modifie pas le profil en soi.
- [Lister les clés API](https://sosoapi.ai/fr/docs/mcp/list-api-keys): MCP: Lister les clés API. Lister les clés API de l’utilisateur (nom, 4 derniers caractères, statut, expiration, filiation) ; définir include_authority pour obtenir aussi les capacités et restrictions d’espaces de travail de chaque clé. Les secrets ne sont jamais renvoyés. Nécessite l’autorisation Manage API keys ; un PAT ne peut pas l’utiliser.
- [Créer une clé API](https://sosoapi.ai/fr/docs/mcp/create-api-key): MCP: Créer une clé API. Créer une clé d’accès personnelle avec les capacités choisies (agent:operate, agent:publish, agent:engage), une restriction workspace_ids facultative et une durée de validité maximale de 365 jours ; le secret n’est renvoyé qu’une fois et ne peut pas être relu. Un agent ne peut accorder que les droits de sa propre autorisation, pour 30 jours au maximum, et la clé cesse de fonctionner à la fin de cette autorisation. Nécessite l’autorisation Manage API keys ; un PAT ne peut pas l’utiliser.
- [Prolonger une clé API](https://sosoapi.ai/fr/docs/mcp/extend-api-key): MCP: Prolonger une clé API. Définir une expiration ultérieure (expires_at) pour une clé API identifiée par id : au plus 365 jours à compter de maintenant, ou 30 pour une clé créée par un agent. Un agent ne peut prolonger que les clés créées par sa propre autorisation. Nécessite l’autorisation Manage API keys.
- [Renouveler une clé API](https://sosoapi.ai/fr/docs/mcp/renew-api-key): MCP: Renouveler une clé API. Créer une clé de remplacement pour une clé API (id), avec un nouveau secret renvoyé une fois et les mêmes capacités et restrictions d’espaces de travail, éventuellement un nouveau nom ou une nouvelle durée (365 jours au maximum, 30 pour une clé créée par un agent). La clé d’origine n’est pas révoquée. Nécessite l’autorisation Manage API keys.
- [Révoquer une clé API](https://sosoapi.ai/fr/docs/mcp/revoke-api-key): MCP: Révoquer une clé API. Révoquer une clé API par id pour la rendre immédiatement inutilisable ; une clé déjà révoquée renvoie already_revoked. Un agent ne peut révoquer que les clés créées par sa propre autorisation. Nécessite l’autorisation Manage API keys.
- [Obtenir le statut de facturation](https://sosoapi.ai/fr/docs/mcp/get-billing-status): MCP: Obtenir le statut de facturation. Lire le forfait de l’utilisateur, l’état du paiement, les dates du cycle actuel et les quotas utilisés (publications réussies, publications programmées en attente, comptes connectés). Vérifiez-les avant de programmer un grand nombre de publications.
- [Obtenir les droits commerciaux](https://sosoapi.ai/fr/docs/mcp/get-commercial-access): MCP: Obtenir les droits commerciaux. Lire le forfait et les quotas du compte de facturation d’un espace de travail, ainsi que son commercial_access_mode (off, shadow ou enforce).
- [Obtenir le contexte de l’organisation](https://sosoapi.ai/fr/docs/mcp/get-organization-context): MCP: Obtenir le contexte de l’organisation. Lire la cartographie actuelle de vos organisations, de leurs espaces de travail et canaux, avec leurs identifiants et rôles. Utilisez-la lorsque les identifiants d’organisation ou de canal sont nécessaires. Pour publier dans un espace de travail, réutilisez un identifiant d’espace de travail renvoyé ; ne lisez pas aussi le contexte de l’espace de travail.
- [Créer un espace de travail](https://sosoapi.ai/fr/docs/mcp/create-workspace): MCP: Créer un espace de travail. Créer un espace de travail dans une organisation dont vous êtes propriétaire ou administrateur. Fournir organization_id si vous appartenez à plusieurs organisations. Utilisez l’id renvoyé pour les appels suivants : ne supposez pas que le nouvel espace devient actif.
- [Obtenir le contexte de l’espace de travail](https://sosoapi.ai/fr/docs/mcp/get-workspace-context): MCP: Obtenir le contexte de l’espace de travail. Lister les espaces de travail de l’utilisateur connecté et indiquer celui qui est actif. Utilisez cet outil lorsque workspace_id est inconnu ; réutilisez le contexte actuel sans répéter les deux lectures de contexte. L’espace actif indiqué est celui qu’une personne a choisi dans l’application web, pas une valeur par défaut pour vos appels : fournissez workspace_id explicitement. Cette opération n’est pas une simple lecture : elle crée le premier espace pour un compte qui n’en a aucun.
- [Mettre à jour un espace de travail](https://sosoapi.ai/fr/docs/mcp/update-workspace): MCP: Mettre à jour un espace de travail. Renommer un espace de travail ou modifier son slug. Propriétaire de l’espace de travail uniquement.
- [Lister les organisations](https://sosoapi.ai/fr/docs/mcp/list-organizations): MCP: Lister les organisations. Lister les organisations de l’utilisateur connecté, avec les identifiants que les outils de portée organisation utilisent comme organization_id.
- [Lister les connexions d’une organisation](https://sosoapi.ai/fr/docs/mcp/list-organization-connections): MCP: Lister les connexions d’une organisation. Lister les connexions fournisseurs d’une organisation (Meta, Instagram, Threads, YouTube) et leur statut. Nécessite organization_id.
- [Examiner une connexion d’organisation](https://sosoapi.ai/fr/docs/mcp/review-organization-connection): MCP: Examiner une connexion d’organisation. Lire les comptes et pages du fournisseur découverts par une opération de connexion en attente (operation_id) pour les examiner. Lecture seule : une personne confirme la connexion dans l’application web.
- [Lister les canaux d’une organisation](https://sosoapi.ai/fr/docs/mcp/list-organization-channels): MCP: Lister les canaux d’une organisation. Lister les canaux d’une organisation (comptes fournisseurs connectés) et l’espace de travail auquel chacun est rattaché.
- [Prévisualiser le déplacement d’un canal](https://sosoapi.ai/fr/docs/mcp/preview-organization-channel-move): MCP: Prévisualiser le déplacement d’un canal. Simulation : vérifier si un canal peut être déplacé vers un autre espace de travail et lister les blocages. Ne modifie rien.
- [Lister les membres d’un espace de travail](https://sosoapi.ai/fr/docs/mcp/list-workspace-members): MCP: Lister les membres d’un espace de travail. Lister les membres d’un espace de travail et ses invitations en attente.
- [Envoyer un retour](https://sosoapi.ai/fr/docs/mcp/submit-feedback): MCP: Envoyer un retour. Envoyer un avis sur le produit (type bug, feature ou general ; jusqu’à 4,000 caractères) à l’équipe SosoAPI au nom de l’utilisateur. À utiliser uniquement sur demande de l’utilisateur.
- [Obtenir les préférences de notification](https://sosoapi.ai/fr/docs/mcp/get-notification-preferences): MCP: Obtenir les préférences de notification. Lire les paramètres de notification de l’utilisateur (actuellement, l’envoi éventuel d’un e-mail en cas d’échec de publication).
- [Mettre à jour les préférences de notification](https://sosoapi.ai/fr/docs/mcp/update-notification-preferences): MCP: Mettre à jour les préférences de notification. Modifier les paramètres de notification de l’utilisateur (email_post_failed activé ou désactivé).
- [Lister les notifications de la boîte de réception](https://sosoapi.ai/fr/docs/mcp/list-inbox-notifications): MCP: Lister les notifications de la boîte de réception. Lire la boîte de réception de l’utilisateur dans l’application, de la plus récente à la plus ancienne (jusqu’à 50), éventuellement uniquement les notifications non lues ou d’un même type.
- [Lister les comptes connectés](https://sosoapi.ai/fr/docs/mcp/list-connected-accounts): MCP: Lister les comptes connectés. Lister les comptes sociaux (Instagram, Threads, Facebook, YouTube) connectés à un espace de travail, avec l’état de connexion et les capacités. Utilisez leurs identifiants comme social_account_id pour programmer ou commenter. Fournissez workspace_id : son absence entraîne un refus lorsque le ciblage explicite est imposé.
- [Déconnecter un compte social](https://sosoapi.ai/fr/docs/mcp/disconnect-social-account): MCP: Déconnecter un compte social. Déconnecter un compte social de son espace de travail (propriétaire de l’espace uniquement). La publication sur ce compte s’arrête jusqu’à ce qu’une personne le reconnecte avec `sosoapi connect`.
- [Définir la synchronisation automatique d’un compte social](https://sosoapi.ai/fr/docs/mcp/set-social-account-auto-sync): MCP: Définir la synchronisation automatique d’un compte social. Activer ou désactiver la synchronisation automatique d’un compte social connecté (rôle editor). Ne publie rien.
- [Lever le blocage d’un compte social](https://sosoapi.ai/fr/docs/mcp/clear-social-account-block): MCP: Lever le blocage d’un compte social. Lever un délai de blocage du fournisseur sur un compte pour permettre la reprise de la publication. Cela ne réessaie aucune publication en échec ; utilisez sosoapi_retry_scheduled_post à cet effet.
- [Rechercher des ressources](https://sosoapi.ai/fr/docs/mcp/query-assets): MCP: Rechercher des ressources. Trouver les ressources d’un espace de travail par asset_type, source ou tag ; renvoie une page (limit jusqu’à 100, plus offset) et le total. Fournissez workspace_id explicitement.
- [Obtenir une ressource](https://sosoapi.ai/fr/docs/mcp/get-asset): MCP: Obtenir une ressource. Lire une ressource par id : métadonnées et URL d’aperçu de courte durée.
- [Créer une ressource](https://sosoapi.ai/fr/docs/mcp/create-asset): MCP: Créer une ressource. Enregistrer une ressource pour un média ou un texte déjà hébergé par vous (asset_url, asset_type). Ne téléverse rien : utilisez sosoapi_upload_asset pour un fichier local ou sosoapi_import_asset_url pour faire récupérer une URL publique par SosoAPI. Fournissez workspace_id (refus en son absence lorsque le ciblage explicite est imposé). idempotency_key facultative.
- [Mettre à jour une ressource](https://sosoapi.ai/fr/docs/mcp/update-asset): MCP: Mettre à jour une ressource. Modifier le titre, la description ou les tags d’une ressource (rôle editor).
- [Supprimer une ressource](https://sosoapi.ai/fr/docs/mcp/delete-asset): MCP: Supprimer une ressource. Supprimer une ressource de la bibliothèque de l’espace de travail par id. Propriétaire de l’espace uniquement.
- [Lister les ressources](https://sosoapi.ai/fr/docs/mcp/list-assets): MCP: Lister les ressources. Lister les ressources d’un espace de travail filtrées par kind (video, image, audio, cover, thumbnail, frame, video-source, branding) ou customer_ready_only, avec pagination next_offset. workspace_id est requis.
- [Importer une ressource par URL](https://sosoapi.ai/fr/docs/mcp/import-asset-url): MCP: Importer une ressource par URL. Demander à SosoAPI de télécharger une image ou vidéo depuis une URL http(s) publique dans le stockage privé de l’espace de travail comme nouvelle ressource. Renvoie un import_id ; interrogez sosoapi_get_asset_import_status. Nécessite une idempotency_key et le rôle editor.
- [Obtenir le statut d’importation d’une ressource](https://sosoapi.ai/fr/docs/mcp/get-asset-import-status): MCP: Obtenir le statut d’importation d’une ressource. Lire une importation par import_id. Pour publier, fournir include_asset=true : un résultat ready inclut l’identifiant de ressource enregistré, kind et l’asset_url stable, évitant un get_asset distinct. Une ressource en attente ou manquante ne peut pas être programmée. N’utilisez jamais l’URL source ou d’aperçu comme identité du média. En cas de blocage, lire sosoapi_job_status avec job_id ; ne lancez jamais d’importation en double.
- [Lister les ressources orphelines](https://sosoapi.ai/fr/docs/mcp/list-orphan-assets): MCP: Lister les ressources orphelines. Lister les objets stockés dans un espace de travail auxquels aucun enregistrement de ressource ne renvoie (nettoyage du stockage), avec pagination par jeton de continuation. Propriétaire de l’espace uniquement.
- [Supprimer les ressources orphelines](https://sosoapi.ai/fr/docs/mcp/delete-orphan-assets): MCP: Supprimer les ressources orphelines. Supprimer par clé les objets de stockage non enregistrés sélectionnés. Propriétaire de l’espace uniquement ; listez-les d’abord avec sosoapi_list_orphan_assets.
- [Obtenir l’inventaire de stockage des ressources](https://sosoapi.ai/fr/docs/mcp/get-asset-storage-inventory): MCP: Obtenir l’inventaire de stockage des ressources. Lire un inventaire paginé des ressources enregistrées et des objets stockés d’un espace de travail pour auditer le stockage.
- [Créer un export de ressources](https://sosoapi.ai/fr/docs/mcp/create-asset-export): MCP: Créer un export de ressources. Exporter les ressources sélectionnées (asset_ids) sous forme de manifeste. Le mode export_verify_then_purge les prépare à une purge ultérieure. idempotency_key facultative.
- [Vérifier un export de ressources](https://sosoapi.ai/fr/docs/mcp/verify-asset-export): MCP: Vérifier un export de ressources. Commencer la vérification d’un export de ressources (export_id). Un export doit être vérifié avant toute demande de purge.
- [Obtenir le statut d’export de ressources](https://sosoapi.ai/fr/docs/mcp/get-asset-export-status): MCP: Obtenir le statut d’export de ressources. Lire le statut d’un export de ressources : exported, verification_required, verifying, verified ou failed.
- [Demander la purge de ressources](https://sosoapi.ai/fr/docs/mcp/request-asset-purge): MCP: Demander la purge de ressources. Demander la suppression définitive des octets stockés des ressources couvertes par un export vérifié (export_id, asset_ids ; confirm_history_loss peut être requis). Propriétaire de l’espace uniquement ; irréversible après suppression.
- [Réessayer la purge de ressources](https://sosoapi.ai/fr/docs/mcp/retry-asset-purge): MCP: Réessayer la purge de ressources. Réessayer une demande de purge arrêtée (purge_request_id). Propriétaire de l’espace uniquement.
- [Lister les projets](https://sosoapi.ai/fr/docs/mcp/list-projects): MCP: Lister les projets. Lister les projets d’un espace de travail (couche facultative de provenance et de comptes par défaut) et indiquer celui qui est actif.
- [Obtenir un projet](https://sosoapi.ai/fr/docs/mcp/get-project): MCP: Obtenir un projet. Lire un projet par id : nom, état du cycle de vie et versions du cycle de vie et des valeurs par défaut nécessaires aux écritures ultérieures.
- [Créer un projet](https://sosoapi.ai/fr/docs/mcp/create-project): MCP: Créer un projet. Créer un projet dans un espace de travail. Propriétaire de l’espace uniquement ; idempotency_key facultative.
- [Mettre à jour un projet](https://sosoapi.ai/fr/docs/mcp/update-project): MCP: Mettre à jour un projet. Renommer un projet (son nom est le seul champ modifiable). Propriétaire de l’espace uniquement.
- [Définir le projet actif](https://sosoapi.ai/fr/docs/mcp/set-active-project): MCP: Définir le projet actif. Définir le projet actif de l’utilisateur (une valeur par défaut côté serveur).
- [Obtenir les comptes par défaut d’un projet](https://sosoapi.ai/fr/docs/mcp/get-project-account-defaults): MCP: Obtenir les comptes par défaut d’un projet. Lire les comptes sociaux par défaut d’un projet et les valeurs spécifiques à chaque compte, avec defaults_version nécessaire au prochain remplacement.
- [Remplacer les comptes par défaut d’un projet](https://sosoapi.ai/fr/docs/mcp/replace-project-account-defaults): MCP: Remplacer les comptes par défaut d’un projet. Remplacer en une seule étape les comptes par défaut et leurs valeurs spécifiques. Nécessite expected_defaults_version issu de la dernière lecture et une idempotency_key (rôle editor).
- [Archiver un projet](https://sosoapi.ai/fr/docs/mcp/archive-project): MCP: Archiver un projet. Archiver un projet sans modifier ses Scheduled Posts. Pour arrêter une publication, annuler séparément ce Scheduled Post. Propriétaire de l’espace de travail uniquement ; fournir expected_lifecycle_version et une idempotency_key.
- [Désarchiver un projet](https://sosoapi.ai/fr/docs/mcp/unarchive-project): MCP: Désarchiver un projet. Réactiver un projet archivé. Cela ne reprend ni ne reprogramme les publications ; gérez-les via Scheduled Posts. Propriétaire de l’espace de travail uniquement ; fournir expected_lifecycle_version et une idempotency_key.
- [Obtenir l’historique du cycle de vie d’un projet](https://sosoapi.ai/fr/docs/mcp/get-project-lifecycle-history): MCP: Obtenir l’historique du cycle de vie d’un projet. Lire jusqu’à 200 événements du cycle de vie d’un projet (comme l’archivage et le désarchivage).
- [Obtenir le profil d’un projet](https://sosoapi.ai/fr/docs/mcp/get-project-profile): MCP: Obtenir le profil d’un projet. Lire le profil de marque d’un projet (slogan, ton, public cible, objectifs, palette, etc.) ; profile vaut null s’il n’existe pas.
- [Mettre à jour le profil d’un projet](https://sosoapi.ai/fr/docs/mcp/update-project-profile): MCP: Mettre à jour le profil d’un projet. Modifier certains champs du profil de marque d’un projet. Les champs omis restent inchangés. Nécessite expected_profile_version issu de la dernière lecture et une idempotency_key (rôle editor).
- [Lister les ressources d’un projet](https://sosoapi.ai/fr/docs/mcp/list-project-assets): MCP: Lister les ressources d’un projet. Lister les ressources associées à un projet avec la relation de chaque lien (identity, source ou reference), avec pagination par curseur.
- [Associer une ressource à un projet](https://sosoapi.ai/fr/docs/mcp/link-project-asset): MCP: Associer une ressource à un projet. Associer une ressource existante à un projet en tant que identity, source ou reference. Rôle editor ; idempotency_key requise.
- [Dissocier une ressource d’un projet](https://sosoapi.ai/fr/docs/mcp/unlink-project-asset): MCP: Dissocier une ressource d’un projet. Supprimer le lien entre une ressource et un projet ; la ressource est conservée. idempotency_key requise.
- [Lister les comptes d’un projet](https://sosoapi.ai/fr/docs/mcp/list-project-accounts): MCP: Lister les comptes d’un projet. Lister les comptes sociaux associés à un projet, avec pagination par curseur.
- [Associer un compte à un projet](https://sosoapi.ai/fr/docs/mcp/link-project-account): MCP: Associer un compte à un projet. Associer un compte social connecté à un projet. Rôle editor ; idempotency_key requise.
- [Dissocier un compte d’un projet](https://sosoapi.ai/fr/docs/mcp/unlink-project-account): MCP: Dissocier un compte d’un projet. Supprimer le lien entre un compte social et un projet ; le compte reste connecté. idempotency_key requise.
- [Créer un export de projet](https://sosoapi.ai/fr/docs/mcp/create-project-export): MCP: Créer un export de projet. Lancer l’export d’un projet (propriétaire de l’espace uniquement) ; interrogez sosoapi_get_project_export_status pour obtenir l’URL de téléchargement. idempotency_key requise.
- [Obtenir le statut d’export d’un projet](https://sosoapi.ai/fr/docs/mcp/get-project-export-status): MCP: Obtenir le statut d’export d’un projet. Lire un export de projet (export_id) : queued, processing, completed (avec une URL de téléchargement de courte durée) ou failed. Propriétaire de l’espace uniquement.
- [Lister les publications nécessitant une intervention](https://sosoapi.ai/fr/docs/mcp/list-publication-attentions): MCP: Lister les publications nécessitant une intervention. Lister les publications d’un espace de travail nécessitant une intervention, filtrées par status (open ou resolved) ou scheduled_post_id, avec pagination par offset.
- [Obtenir les crédits de publication X](https://sosoapi.ai/fr/docs/mcp/get-x-usage): MCP: Obtenir les crédits de publication X. Lire les crédits de publication X de l’organisation partagés par cet espace de travail. Nécessite workspace_id. Free reçoit 10 crédits une fois ; Pro en reçoit 100 par période de facturation. Un texte coûte 1 crédit ; un texte contenant une URL en coûte 10. Un texte facultatif permet d’en connaître le coût. Lit le quota enregistré sans appeler l’API X.
- [Lister les publications programmées](https://sosoapi.ai/fr/docs/mcp/list-scheduled-posts): MCP: Lister les publications programmées. Lister les publications programmées d’un espace de travail, filtrables par projet, statut (scheduled, publishing, published, failed, expired, needs_reschedule, cancelled, deleted) et période, avec pagination par curseur.
- [Obtenir une publication programmée](https://sosoapi.ai/fr/docs/mcp/get-scheduled-post): MCP: Obtenir une publication programmée. Lire une publication programmée par id : contenu, statut, état de diffusion et résultats. Sa version est nécessaire aux opérations de mise à jour, de publication, de nouvelle tentative et d’annulation sous expected_version.
- [Obtenir l’éligibilité d’une publication programmée](https://sosoapi.ai/fr/docs/mcp/get-scheduled-post-eligibility): MCP: Obtenir l’éligibilité d’une publication programmée. Contrôle préalable en lecture seule par destination. Inclure draft (caption, hashtags, scheduled_at, display_timezone, heure locale/DST facultative) pour vérifier le contenu et le moment ; include_quota=true ajoute un aperçu indicatif des quotas de la période. Téléversez/importez les médias et attendez qu’ils soient prêts. Sans draft, seuls le compte et les médias sont vérifiés. Ne réserve rien ; la création et la diffusion vérifient à nouveau les limites et les droits.
- [Créer une publication programmée](https://sosoapi.ai/fr/docs/mcp/create-scheduled-post): MCP: Créer une publication programmée. Programmer un compte à scheduled_at avec provider_payload. Les médias nécessitent un asset_id prêt et une URL canonique ; pour une seule image source, utilisez sosoapi_post_image_url. Associez local_scheduled_at à schedule_dst_disambiguation ou omettez les deux. Nécessite publish, le rôle editor et idempotency_key. Programmée ne signifie pas publiée : consultez son résultat.
- [Créer des publications programmées par lot](https://sosoapi.ai/fr/docs/mcp/bulk-create-scheduled-posts): MCP: Créer des publications programmées par lot. Programmer des publications pour plusieurs comptes en un appel (targets). Les médias nécessitent des asset_ids téléversés/importés prêts et leurs URL canoniques. Chaque cible réussit ou échoue indépendamment et figure dans successes ou failures. Nécessite la capacité publish.
- [Mettre à jour une publication programmée](https://sosoapi.ai/fr/docs/mcp/update-scheduled-post): MCP: Mettre à jour une publication programmée. Modifier une publication programmée qui n’a pas encore été envoyée (légende, hashtags, médias, lien, heure). Nécessite expected_version issu de la dernière lecture ; une version périmée est rejetée.
- [Publier immédiatement une publication programmée](https://sosoapi.ai/fr/docs/mcp/publish-scheduled-post-now): MCP: Publier immédiatement une publication programmée. Publier une publication programmée immédiatement au lieu d’attendre scheduled_at. Action publique et irréversible ; nécessite expected_version. En file ne signifie pas publiée : consultez le résultat.
- [Réessayer une publication programmée](https://sosoapi.ai/fr/docs/mcp/retry-scheduled-post): MCP: Réessayer une publication programmée. Réessayer une publication programmée en échec, éventuellement à un nouveau scheduled_at. Nécessite expected_version.
- [Supprimer une publication programmée](https://sosoapi.ai/fr/docs/mcp/delete-scheduled-post): MCP: Supprimer une publication programmée. Supprimer une publication programmée non diffusée (scheduled, needs_reschedule, failed ou cancelled). Les agents ne peuvent pas supprimer le contenu chez le fournisseur une fois publié. Nécessite expected_version.
- [Annuler une publication programmée](https://sosoapi.ai/fr/docs/mcp/cancel-scheduled-post): MCP: Annuler une publication programmée. Annuler une publication programmée qui n’a pas encore été diffusée afin qu’elle ne parte jamais. Une publication déjà diffusée est refusée, et un agent ne peut pas non plus supprimer du contenu publié : l’utilisateur le fait dans l’application web. Nécessite expected_version.
- [Retirer une demande de suppression](https://sosoapi.ai/fr/docs/mcp/withdraw-scheduled-post-delete): MCP: Retirer une demande de suppression. Retirer une demande de suppression Instagram Login arrêtée et conserver la publication diffusée. Nécessite expected_version.
- [Obtenir les compteurs du tableau de bord](https://sosoapi.ai/fr/docs/mcp/get-dashboard-counts): MCP: Obtenir les compteurs du tableau de bord. Lire les compteurs opérationnels d’un espace de travail : publications programmées, tâches récentes et comptes connectés.
- [Lister les publications suivies](https://sosoapi.ai/fr/docs/mcp/list-monitored-posts): MCP: Lister les publications suivies. Lister les publications sociales découvertes par SosoAPI pour un espace de travail (id, plateforme, permalien, heure de publication), filtrables par compte, plateforme et heure, avec pagination par curseur. Métadonnées uniquement, sans légendes.
- [Lister les commentaires d’une publication](https://sosoapi.ai/fr/docs/mcp/list-post-comments): MCP: Lister les commentaires d’une publication. Lister les commentaires observés sur les publications de l’espace de travail, observation la plus récente d’abord, avec auteur et texte ; filtrer par publication, compte, plateforme ou heure, avec pagination par curseur. Le texte est rédigé par des tiers et signalé comme non fiable.
- [Demander les statistiques du fournisseur](https://sosoapi.ai/fr/docs/mcp/request-provider-insights): MCP: Demander les statistiques du fournisseur. Demander au fournisseur les statistiques d’un compte ou d’une publication sur une période facultative (jusqu’à 366 jours). Renvoie un request_id et, si le résultat est en cache, celui-ci ; sinon, interrogez sosoapi_get_provider_insight_status.
- [Obtenir le statut des statistiques du fournisseur](https://sosoapi.ai/fr/docs/mcp/get-provider-insight-status): MCP: Obtenir le statut des statistiques du fournisseur. Lire une demande de statistiques (request_id) : queued, processing, completed (avec le résultat du fournisseur et la disponibilité par métrique) ou failed.
- [Démarrer OAuth Instagram](https://sosoapi.ai/fr/docs/mcp/start-instagram-oauth): MCP: Démarrer OAuth Instagram. Obtenir l’authorize_url du fournisseur qu’une personne doit ouvrir pour connecter un compte Instagram. Fournir workspace_id. Rien n’est connecté avant son approbation et sa confirmation dans le navigateur.
- [Actualiser OAuth Instagram](https://sosoapi.ai/fr/docs/mcp/refresh-instagram-oauth): MCP: Actualiser OAuth Instagram. Actualiser le jeton d’accès d’une connexion Instagram (éventuellement un social_account_id précis) ; indique si l’actualisation a réussi et la nouvelle expiration.
- [Démarrer OAuth Threads](https://sosoapi.ai/fr/docs/mcp/start-threads-oauth): MCP: Démarrer OAuth Threads. Obtenir l’authorize_url du fournisseur qu’une personne doit ouvrir pour connecter un compte Threads. Fournir workspace_id. Rien n’est connecté avant son approbation et sa confirmation dans le navigateur.
- [Actualiser OAuth Threads](https://sosoapi.ai/fr/docs/mcp/refresh-threads-oauth): MCP: Actualiser OAuth Threads. Actualiser le jeton d’accès d’une connexion Threads (éventuellement un social_account_id précis) ; indique si l’actualisation a réussi et la nouvelle expiration.
- [Vérifier OAuth Threads](https://sosoapi.ai/fr/docs/mcp/check-threads-oauth): MCP: Vérifier OAuth Threads. Lire l’état de la connexion Threads : connexion, expiration, périmètre et possibilité d’actualisation. Fournir workspace_id.
- [Démarrer OAuth Meta](https://sosoapi.ai/fr/docs/mcp/start-meta-oauth): MCP: Démarrer OAuth Meta. Obtenir l’authorize_url du fournisseur qu’une personne doit ouvrir pour connecter une Page Facebook ou Instagram via Facebook (connection_intent). Fournir workspace_id. Rien n’est connecté avant son approbation et sa confirmation dans le navigateur.
- [Actualiser OAuth Meta](https://sosoapi.ai/fr/docs/mcp/refresh-meta-oauth): MCP: Actualiser OAuth Meta. Vérifier à nouveau une connexion Facebook/Meta (social_account_id) et renvoyer capability_verified.
- [Démarrer OAuth YouTube](https://sosoapi.ai/fr/docs/mcp/start-youtube-oauth): MCP: Démarrer OAuth YouTube. Obtenir l’authorize_url du fournisseur qu’une personne doit ouvrir pour connecter une chaîne YouTube. Fournir workspace_id. Rien n’est connecté avant son approbation et sa confirmation dans le navigateur.
- [Actualiser OAuth YouTube](https://sosoapi.ai/fr/docs/mcp/refresh-youtube-oauth): MCP: Actualiser OAuth YouTube. Actualiser le jeton d’une connexion YouTube (social_account_id) ; renvoie la nouvelle expiration et capability_verified.
- [Lister les tâches](https://sosoapi.ai/fr/docs/mcp/list-jobs): MCP: Lister les tâches. Lister les tâches récentes en arrière-plan de l’utilisateur connecté avec leur statut et leur progression.
- [Obtenir le statut d’une tâche](https://sosoapi.ai/fr/docs/mcp/job-status): MCP: Obtenir le statut d’une tâche. Lire une tâche en arrière-plan par job_id : statut, type et message d’erreur en cas d’échec.
- [Obtenir le résultat d’envoi d’un commentaire](https://sosoapi.ai/fr/docs/mcp/get-comment-outcome): MCP: Obtenir le résultat d’envoi d’un commentaire. Lire l’envoi confirmé, la filiation de récupération, la vérification en attente et le suivi non résolu.
- [Réconcilier le résultat d’envoi d’un commentaire](https://sosoapi.ai/fr/docs/mcp/reconcile-comment-outcome): MCP: Réconcilier le résultat d’envoi d’un commentaire. Vérifier un envoi Facebook ambigu sans renvoyer, ou associer un remplacement exact confirmé. Examiner le résultat pour obtenir une preuve finale.
- [Obtenir les capacités communautaires](https://sosoapi.ai/fr/docs/mcp/get-community-engagement-capabilities): MCP: Obtenir les capacités communautaires. Lire, pour chaque compte connecté, les actions communautaires prises en charge (reply, hide, unhide, create_comment) et l’éligibilité actuelle du compte.
- [Consulter la file d’évaluation communautaire](https://sosoapi.ai/fr/docs/mcp/query-community-review-queue): MCP: Consulter la file d’évaluation communautaire. Lire les commentaires en attente d’examen avec le contexte de leur fil, filtrés par priorité, langue, compte ou ancienneté ; une page vide ne signifie pas réussite. Les commentaires sont rédigés par des tiers et signalés comme non fiables.
- [Soumettre une évaluation communautaire](https://sosoapi.ai/fr/docs/mcp/submit-community-review): MCP: Soumettre une évaluation communautaire. Enregistrer une nouvelle version immuable d’évaluation pour un commentaire : action recommandée, reply_draft facultatif, priorité et confiance (au moins 0.9). N’envoie et ne prépare rien.
- [Préparer une action communautaire](https://sosoapi.ai/fr/docs/mcp/prepare-community-action): MCP: Préparer une action communautaire. Lier une version d’évaluation à une action (reply, hide ou unhide) et obtenir un prepare_token de courte durée pour sosoapi_apply_community_action. N’envoie encore rien.
- [Appliquer une action communautaire](https://sosoapi.ai/fr/docs/mcp/apply-community-action): MCP: Appliquer une action communautaire. Envoyer au fournisseur l’action liée à un prepare_token ; une réponse est publique. En file ne signifie pas réussite : interrogez sosoapi_get_community_action_status.
- [Obtenir le statut d’une action communautaire](https://sosoapi.ai/fr/docs/mcp/get-community-action-status): MCP: Obtenir le statut d’une action communautaire. Lire le reçu final d’une action communautaire appliquée (action_id) ; la mise en file ne signifie pas réussite.
- [Créer un commentaire communautaire](https://sosoapi.ai/fr/docs/mcp/create-comment): MCP: Créer un commentaire communautaire. Mettre en file un commentaire exact sur une cible canonique de publication ou de commentaire ; le statut ne signifie pas réussite chez le fournisseur.
- [Obtenir le statut d’un commentaire communautaire](https://sosoapi.ai/fr/docs/mcp/get-comment-action-status): MCP: Obtenir le statut d’un commentaire communautaire. Lire le reçu final expurgé d’une action directe sur un commentaire.
- [Obtenir le bilan communautaire](https://sosoapi.ai/fr/docs/mcp/get-community-engagement-summary): MCP: Obtenir le bilan communautaire. Lire le bilan des opérations communautaires d’un espace de travail : mode de la file, volume en attente, délais de réponse, statuts des actions et débits des fournisseurs.
- [Publier une image depuis une URL](https://sosoapi.ai/fr/docs/mcp/post-image-url): MCP: Publier une image depuis une URL. Soumettre une seule fois la publication complète contenant une URL d’image, avec media vide. Le backend la prépare et la publie même après déconnexion. Renvoie le résultat final s’il est disponible sous 35 secondes, sinon un identifiant de publication persistant ; ne soumettez jamais à nouveau avec une nouvelle clé. Nécessite les autorisations operate et publish. Les champs heure locale/DST vont ensemble. import_id sert uniquement à reprendre avec d’anciens clients.
- [Téléverser une image ou une vidéo locale](https://sosoapi.ai/fr/docs/mcp/upload-asset): MCP: Téléverser une image ou une vidéo locale. Téléverser un fichier image ou vidéo local dans la bibliothèque de ressources d’un espace de travail et l’enregistrer comme ressource. Seuls de véritables fichiers PNG/JPEG/GIF/WebP/MP4/MOV/WebM/MKV/MPEG de 500 MiB maximum, issus du répertoire de travail, du dossier temporaire, de Pictures/Movies/Videos ou de SOSOAPI_UPLOAD_ROOTS sont acceptés ; les fichiers et dossiers cachés commençant par un point sont refusés. Renvoie l’identifiant de ressource et l’URL pour les médias de Scheduled Post.