purrplan

{'type': 'object', 'required': ['workspace_uuid', 'account_ids', 'content'], 'properties': {'content': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}, 'minItems': 1}], 'description': 'Texte du post (appliqué à tous les comptes). String = post simple. Tableau de strings = post + suites : thread sur X/Threads/Mastodon/Bluesky, PREMIER COMMENTAIRE sur Facebook/Instagram, ignoré ailleurs (voir `warnings` dans la réponse).'}, 'options': {'type': 'object', 'description': 'Réglages propres à un réseau, indexés par nom de provider (celui renvoyé par list_accounts). Exemple : {"threads": {"topic_tag": "buildinpublic"}}. Pour publier une STORY plutôt qu\'un post de fil : {"facebook_page": {"type": "story"}} (valeurs post|reel|story sur Instagram, Instagram Direct et Facebook Page). Chaque réseau valide ses propres clés ; une clé inconnue ou un provider non ciblé par `account_ids` est refusé.', 'additionalProperties': {'type': 'object'}}, 'account_ids': {'type': 'array', 'items': {'type': 'integer'}, 'minItems': 1, 'description': 'IDs numériques des comptes cibles (issus de list_accounts)'}, 'media_uuids': {'type': 'array', 'items': {'type': 'string'}, 'description': 'UUIDs des médias à attacher (obtenus via upload_media_from_url)'}, 'scheduled_at': {'type': 'string', 'format': 'date-time', 'description': 'Date/heure UTC ISO 8601. Si fourni, programme le post au lieu de créer un brouillon.'}, 'workspace_uuid': {'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['workspace_uuid', 'account_ids', 'media_uuids'], 'properties': {'captions': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Texte optionnel par story, dans le même ordre que media_uuids. Une seule valeur = appliquée à toutes.'}, 'account_ids': {'type': 'array', 'items': {'type': 'integer'}, 'minItems': 1, 'description': 'IDs des comptes cibles (issus de list_accounts). Seuls Instagram, Instagram Direct, Facebook Page et Facebook (extension) sont acceptés.'}, 'media_uuids': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 30, 'minItems': 1, 'description': "UUIDs des médias, DANS L'ORDRE de publication souhaité (via upload_media_from_url). Une story par média."}, 'scheduled_at': {'type': 'string', 'format': 'date-time', 'description': 'Heure UTC ISO 8601 de la PREMIÈRE story. Absent = brouillons.'}, 'workspace_uuid': {'type': 'string'}, 'interval_minutes': {'type': 'integer', 'maximum': 240, 'minimum': 1, 'description': 'Minutes entre deux stories (défaut 2). Minimum 1 : deux stories à la même minute partiraient dans un ordre non garanti.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['workspace_uuid'], 'properties': {'post_uuid': {'type': 'string', 'description': 'UUID du post à supprimer'}, 'post_uuids': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Suppression en lot (alternative à post_uuid)'}, 'workspace_uuid': {'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['workspace_uuid', 'prompt'], 'properties': {'tone': {'enum': ['neutral', 'friendly', 'formal', 'edgy', 'engaging'], 'type': 'string', 'default': 'neutral'}, 'prompt': {'type': 'string', 'description': 'Sujet ou idée du post à générer'}, 'instructions': {'type': 'string', 'description': 'Instructions additionnelles optionnelles (style, contexte, angle…)'}, 'workspace_uuid': {'type': 'string'}, 'character_limit': {'type': 'integer', 'default': 2200, 'maximum': 10000, 'minimum': 50, 'description': 'Limite de caractères (ex: 280 pour Twitter, 2200 pour Instagram)'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['workspace_uuid'], 'properties': {'days': {'enum': [7, 30, 90, 365], 'type': 'integer', 'default': 30, 'description': 'Fenêtre en jours.'}, 'workspace_uuid': {'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['workspace_uuid', 'message_id'], 'properties': {'message_id': {'type': 'integer', 'description': 'Identifiant renvoyé par list_inbox.'}, 'workspace_uuid': {'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['workspace_uuid', 'post_uuid'], 'properties': {'post_uuid': {'type': 'string'}, 'workspace_uuid': {'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['workspace_uuid', 'post_uuid'], 'properties': {'days': {'enum': [7, 30, 90, 365], 'type': 'integer', 'default': 30, 'description': 'Ne concerne que les clics tracés : les compteurs des réseaux sont cumulés depuis la parution.'}, 'post_uuid': {'type': 'string', 'description': 'uuid de la publication, tel que rendu par list_posts, create_draft_post et les webhooks.'}, 'workspace_uuid': {'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['workspace_uuid'], 'properties': {'days': {'enum': [7, 30, 90, 365], 'type': 'integer', 'default': 30}, 'limit': {'type': 'integer', 'default': 6, 'maximum': 20, 'minimum': 1}, 'include_trends': {'type': 'boolean', 'default': False, 'description': 'Ajoute les séries jour par jour (audience, engagement). Volumineux.'}, 'workspace_uuid': {'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['workspace_uuid'], 'properties': {'workspace_uuid': {'type': 'string', 'description': 'UUID du workspace (obtenu via list_workspaces)'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['workspace_uuid'], 'properties': {'type': {'enum': ['comment', 'dm', 'mention'], 'type': 'string', 'description': 'Filtrer sur un type de conversation.'}, 'limit': {'type': 'integer', 'default': 20, 'maximum': 50, 'minimum': 1}, 'search': {'type': 'string', 'description': 'Recherche dans le contenu et les auteurs.'}, 'status': {'enum': ['unread', 'all', 'archived'], 'type': 'string', 'default': 'unread'}, 'provider': {'type': 'string', 'description': 'Filtrer sur un réseau (instagram_direct, facebook_page…).'}, 'workspace_uuid': {'type': 'string', 'description': 'UUID du workspace.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['workspace_uuid'], 'properties': {'limit': {'type': 'integer', 'default': 20, 'maximum': 100, 'minimum': 1}, 'status': {'enum': ['draft', 'scheduled', 'published', 'failed', 'needs_approval'], 'type': 'string', 'description': 'Filtre optionnel par statut'}, 'workspace_uuid': {'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {}, 'additionalProperties': False}

{'type': 'object', 'required': ['workspace_uuid', 'message_ids', 'action'], 'properties': {'action': {'enum': ['read', 'unread', 'archive', 'unarchive', 'assign'], 'type': 'string'}, 'assign_to': {'type': ['integer', 'null'], 'description': "Identifiant d'un membre de l'espace, ou null pour rendre la conversation. Requis pour `assign`."}, 'message_ids': {'type': 'array', 'items': {'type': 'integer'}, 'maxItems': 100}, 'workspace_uuid': {'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['workspace_uuid', 'brief'], 'properties': {'tone': {'enum': ['neutral', 'friendly', 'formal', 'edgy', 'engaging'], 'type': 'string', 'default': 'neutral'}, 'brief': {'type': 'string', 'description': 'Ce dont la semaine doit parler : thème, actualité, offre, angle éditorial.'}, 'count': {'type': 'integer', 'default': 5, 'maximum': 12, 'minimum': 1, 'description': 'Nombre de publications à produire.'}, 'confirm': {'type': 'boolean', 'description': 'Obligatoire avec `schedule: true` : les publications partiront toutes seules.'}, 'schedule': {'type': 'boolean', 'default': False, 'description': "true = programmer sur les créneaux de l'espace. false = brouillons non datés."}, 'account_ids': {'type': 'array', 'items': {'type': 'integer'}, 'description': 'Comptes cibles (list_accounts). Par défaut : tous les comptes connectés de cet espace.'}, 'instructions': {'type': 'string', 'description': 'Consignes de style additionnelles (interdits, vocabulaire, appel à action…).'}, 'workspace_uuid': {'type': 'string'}, 'character_limit': {'type': 'integer', 'default': 900, 'maximum': 3000, 'minimum': 50, 'description': 'Longueur maximale par publication. Descendez à 280 si un compte X est ciblé.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['workspace_uuid'], 'properties': {'workspace_uuid': {'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['workspace_uuid', 'message_id', 'text', 'confirm'], 'properties': {'text': {'type': 'string', 'maxLength': 3000}, 'confirm': {'type': 'boolean', 'description': "Doit valoir true. Garde-fou explicite : l'envoi est réel et irréversible."}, 'message_id': {'type': 'integer', 'description': 'Message auquel répondre (list_inbox / get_inbox_thread).'}, 'workspace_uuid': {'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['workspace_uuid', 'post_uuid'], 'properties': {'content': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}, 'minItems': 1}], 'description': 'Nouveau texte (remplace tout). String = post simple ; tableau de strings = thread (un bloc par élément). Omis = texte conservé.'}, 'post_uuid': {'type': 'string'}, 'account_ids': {'type': 'array', 'items': {'type': 'integer'}, 'description': 'Remplace les comptes cibles. Omis = comptes conservés.'}, 'media_uuids': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Remplace les médias du premier bloc (ordre préservé). Tableau vide = retire les médias. Omis = médias conservés.'}, 'scheduled_at': {'type': ['string', 'null'], 'format': 'date-time', 'description': 'Date de publication (ISO 8601 UTC) : programme le post. `null` DÉPROGRAMME et le repasse en brouillon. Omis = programmation inchangée.'}, 'workspace_uuid': {'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['workspace_uuid', 'url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'URL publique du fichier à télécharger (https recommandé)'}, 'type': {'enum': ['uploads', 'library'], 'type': 'string', 'default': 'library', 'description': 'Dossier de destination. library = bibliothèque partagée, uploads = uploads éphémères.'}, 'filename': {'type': 'string', 'description': "Nom de fichier forcé (facultatif). Sinon extrait de l'URL."}, 'workspace_uuid': {'type': 'string'}}, 'additionalProperties': False}