{"openapi":"3.1.0","info":{"title":"API STRIKE","version":"2026-10-01","description":"API privée de STRIKE (offres Pro et Enterprise) : leads, événements, segments, tunnels, flux, parcours, réseaux sociaux, paiements et webhooks.\n\nAuthentification : `Authorization: Bearer <clé API sk_live_…>` ou jeton OAuth 2.1 d’un agent connecté. Chaque appel est limité par les permissions (scopes) du jeton.\n\nPagination par curseur (`limit`, `cursor`, `has_more`, `next_cursor`), dates ISO 8601 en UTC, `Idempotency-Key` sur les requêtes POST, erreurs au format `{ \"error\": { \"type\", \"message\", \"code\", \"param\", \"request_id\" } }`.","contact":{"name":"Support STRIKE","url":"https://strikespace.net/developpeurs"}},"servers":[{"url":"https://strikespace.net/api/platform/v1","description":"Production"}],"tags":[{"name":"Espace"},{"name":"Leads"},{"name":"Événements"},{"name":"Segments"},{"name":"Tunnels"},{"name":"Flux"},{"name":"Parcours"},{"name":"Réseaux sociaux"},{"name":"Paiements"},{"name":"Webhooks"}],"security":[{"bearerAuth":[]},{"oauth2":[]}],"paths":{"/me":{"get":{"operationId":"getWorkspace","summary":"Espace de travail courant","description":"Espace, offre, permissions et limites du jeton utilisé.\n\nAucun scope requis.","tags":["Espace"],"security":[{"bearerAuth":[]},{"oauth2":[]}],"parameters":[],"responses":{"200":{"description":"Espace courant.","headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute pour ce jeton.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la fenêtre courante.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la réinitialisation de la fenêtre.","schema":{"type":"integer"}},"X-Request-Id":{"description":"Identifiant de la requête, à communiquer au support.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Workspace"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/leads":{"get":{"operationId":"listLeads","summary":"Lister les leads","description":"Scope requis : `leads:read`.","tags":["Leads"],"security":[{"bearerAuth":[]},{"oauth2":["leads:read"]}],"x-required-scope":"leads:read","parameters":[{"name":"limit","in":"query","required":false,"description":"Nombre d’éléments (1 à 100, 25 par défaut).","schema":{"type":"integer","minimum":1,"maximum":100,"default":25}},{"name":"cursor","in":"query","required":false,"description":"Curseur opaque `next_cursor` de la page précédente.","schema":{"type":"string"}},{"name":"status","in":"query","required":false,"description":"Filtrer par statut.","schema":{"type":"string","enum":["cold","warm","converted","blacklisted"]}},{"name":"email","in":"query","required":false,"description":"Email exact (insensible à la casse).","schema":{"type":"string"}},{"name":"phone_number","in":"query","required":false,"description":"Numéro exact.","schema":{"type":"string"}},{"name":"funnel_id","in":"query","required":false,"description":"Tunnel d’origine.","schema":{"type":"string","format":"uuid"}},{"name":"created_after","in":"query","required":false,"description":"Créés à partir de (ISO 8601).","schema":{"type":"string","format":"date-time"}},{"name":"created_before","in":"query","required":false,"description":"Créés avant (ISO 8601).","schema":{"type":"string","format":"date-time"}},{"name":"q","in":"query","required":false,"description":"Recherche dans le prénom, l’email et le téléphone.","schema":{"type":"string"}}],"responses":{"200":{"description":"Liste de leads.","headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute pour ce jeton.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la fenêtre courante.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la réinitialisation de la fenêtre.","schema":{"type":"integer"}},"X-Request-Id":{"description":"Identifiant de la requête, à communiquer au support.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/List"},{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Lead"}}}}]}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"422":{"$ref":"#/components/responses/Invalid"},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"post":{"operationId":"upsertLead","summary":"Créer ou mettre à jour un lead","description":"Rapprochement par email puis par téléphone. 201 à la création, 200 avec `created: false` si le lead existait. Soumis au quota mensuel et aux canaux de votre offre.\n\nScope requis : `leads:write`.","tags":["Leads"],"security":[{"bearerAuth":[]},{"oauth2":["leads:write"]}],"x-required-scope":"leads:write","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Clé unique (≤ 255 caractères) pour rejouer une requête sans effet de bord pendant 24 h. Même clé + corps différent → 409.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LeadUpsert"}}}},"responses":{"200":{"description":"Lead existant mis à jour.","headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute pour ce jeton.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la fenêtre courante.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la réinitialisation de la fenêtre.","schema":{"type":"integer"}},"X-Request-Id":{"description":"Identifiant de la requête, à communiquer au support.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Lead"},{"type":"object","properties":{"created":{"const":false}}}]}}}},"201":{"description":"Lead créé.","headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute pour ce jeton.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la fenêtre courante.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la réinitialisation de la fenêtre.","schema":{"type":"integer"}},"X-Request-Id":{"description":"Identifiant de la requête, à communiquer au support.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Lead"},{"type":"object","properties":{"created":{"const":true}}}]}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/Invalid"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/leads/{id}":{"get":{"operationId":"getLead","summary":"Détail d’un lead","description":"Scope requis : `leads:read`.","tags":["Leads"],"security":[{"bearerAuth":[]},{"oauth2":["leads:read"]}],"x-required-scope":"leads:read","parameters":[{"name":"id","in":"path","required":true,"description":"Identifiant du lead.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Lead.","headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute pour ce jeton.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la fenêtre courante.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la réinitialisation de la fenêtre.","schema":{"type":"integer"}},"X-Request-Id":{"description":"Identifiant de la requête, à communiquer au support.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Lead"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"patch":{"operationId":"updateLead","summary":"Modifier un lead","description":"`traits` est fusionné avec les attributs existants.\n\nScope requis : `leads:write`.","tags":["Leads"],"security":[{"bearerAuth":[]},{"oauth2":["leads:write"]}],"x-required-scope":"leads:write","parameters":[{"name":"id","in":"path","required":true,"description":"Identifiant du lead.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LeadUpdate"}}}},"responses":{"200":{"description":"Lead modifié.","headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute pour ce jeton.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la fenêtre courante.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la réinitialisation de la fenêtre.","schema":{"type":"integer"}},"X-Request-Id":{"description":"Identifiant de la requête, à communiquer au support.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Lead"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/Invalid"},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"delete":{"operationId":"deleteLead","summary":"Effacer un lead (RGPD)","description":"Supprime définitivement le lead, ses événements et ses inscriptions. Les paiements sont conservés sans l’acheteur.\n\nScope requis : `leads:write`.","tags":["Leads"],"security":[{"bearerAuth":[]},{"oauth2":["leads:write"]}],"x-required-scope":"leads:write","parameters":[{"name":"id","in":"path","required":true,"description":"Identifiant du lead.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Lead effacé.","headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute pour ce jeton.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la fenêtre courante.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la réinitialisation de la fenêtre.","schema":{"type":"integer"}},"X-Request-Id":{"description":"Identifiant de la requête, à communiquer au support.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Deleted"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/leads/{id}/events":{"get":{"operationId":"listLeadEvents","summary":"Événements d’un lead","description":"Scope requis : `events:read`.","tags":["Événements"],"security":[{"bearerAuth":[]},{"oauth2":["events:read"]}],"x-required-scope":"events:read","parameters":[{"name":"id","in":"path","required":true,"description":"Identifiant du lead.","schema":{"type":"string","format":"uuid"}},{"name":"limit","in":"query","required":false,"description":"Nombre d’éléments (1 à 100, 25 par défaut).","schema":{"type":"integer","minimum":1,"maximum":100,"default":25}},{"name":"cursor","in":"query","required":false,"description":"Curseur opaque `next_cursor` de la page précédente.","schema":{"type":"string"}},{"name":"name","in":"query","required":false,"description":"Nom d’événement.","schema":{"type":"string"}},{"name":"since","in":"query","required":false,"description":"Depuis (ISO 8601).","schema":{"type":"string","format":"date-time"}}],"responses":{"200":{"description":"Événements.","headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute pour ce jeton.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la fenêtre courante.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la réinitialisation de la fenêtre.","schema":{"type":"integer"}},"X-Request-Id":{"description":"Identifiant de la requête, à communiquer au support.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/List"},{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Event"}}}}]}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/events":{"get":{"operationId":"listEvents","summary":"Lister les événements","description":"Scope requis : `events:read`.","tags":["Événements"],"security":[{"bearerAuth":[]},{"oauth2":["events:read"]}],"x-required-scope":"events:read","parameters":[{"name":"limit","in":"query","required":false,"description":"Nombre d’éléments (1 à 100, 25 par défaut).","schema":{"type":"integer","minimum":1,"maximum":100,"default":25}},{"name":"cursor","in":"query","required":false,"description":"Curseur opaque `next_cursor` de la page précédente.","schema":{"type":"string"}},{"name":"lead_id","in":"query","required":false,"description":"Lead.","schema":{"type":"string","format":"uuid"}},{"name":"name","in":"query","required":false,"description":"Nom d’événement.","schema":{"type":"string"}},{"name":"since","in":"query","required":false,"description":"Depuis (ISO 8601).","schema":{"type":"string","format":"date-time"}}],"responses":{"200":{"description":"Événements.","headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute pour ce jeton.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la fenêtre courante.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la réinitialisation de la fenêtre.","schema":{"type":"integer"}},"X-Request-Id":{"description":"Identifiant de la requête, à communiquer au support.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/List"},{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Event"}}}}]}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"422":{"$ref":"#/components/responses/Invalid"},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"post":{"operationId":"trackEvent","summary":"Envoyer un événement","description":"Rattaché à un lead (lead_id, email ou phone_number) ou à un visiteur anonyme (anonymous_id). Traité de façon asynchrone (202) ; peut déclencher des parcours.\n\nScope requis : `events:write`.","tags":["Événements"],"security":[{"bearerAuth":[]},{"oauth2":["events:write"]}],"x-required-scope":"events:write","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Clé unique (≤ 255 caractères) pour rejouer une requête sans effet de bord pendant 24 h. Même clé + corps différent → 409.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventCreate"}}}},"responses":{"202":{"description":"Événement accepté.","headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute pour ce jeton.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la fenêtre courante.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la réinitialisation de la fenêtre.","schema":{"type":"integer"}},"X-Request-Id":{"description":"Identifiant de la requête, à communiquer au support.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventAccepted"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/Invalid"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/segments":{"get":{"operationId":"listSegments","summary":"Lister les segments","description":"Scope requis : `segments:read`.","tags":["Segments"],"security":[{"bearerAuth":[]},{"oauth2":["segments:read"]}],"x-required-scope":"segments:read","parameters":[{"name":"limit","in":"query","required":false,"description":"Nombre d’éléments (1 à 100, 25 par défaut).","schema":{"type":"integer","minimum":1,"maximum":100,"default":25}},{"name":"cursor","in":"query","required":false,"description":"Curseur opaque `next_cursor` de la page précédente.","schema":{"type":"string"}}],"responses":{"200":{"description":"Segments.","headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute pour ce jeton.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la fenêtre courante.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la réinitialisation de la fenêtre.","schema":{"type":"integer"}},"X-Request-Id":{"description":"Identifiant de la requête, à communiquer au support.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/List"},{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Segment"}}}}]}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/segments/{id}":{"get":{"operationId":"getSegment","summary":"Détail d’un segment","description":"Scope requis : `segments:read`.","tags":["Segments"],"security":[{"bearerAuth":[]},{"oauth2":["segments:read"]}],"x-required-scope":"segments:read","parameters":[{"name":"id","in":"path","required":true,"description":"Identifiant du segment.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Segment avec lead_count.","headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute pour ce jeton.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la fenêtre courante.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la réinitialisation de la fenêtre.","schema":{"type":"integer"}},"X-Request-Id":{"description":"Identifiant de la requête, à communiquer au support.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Segment"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/segments/{id}/leads":{"get":{"operationId":"listSegmentLeads","summary":"Membres d’un segment","description":"Scope requis : `segments:read`.","tags":["Segments"],"security":[{"bearerAuth":[]},{"oauth2":["segments:read"]}],"x-required-scope":"segments:read","parameters":[{"name":"id","in":"path","required":true,"description":"Identifiant du segment.","schema":{"type":"string","format":"uuid"}},{"name":"limit","in":"query","required":false,"description":"Nombre d’éléments (1 à 100, 25 par défaut).","schema":{"type":"integer","minimum":1,"maximum":100,"default":25}},{"name":"cursor","in":"query","required":false,"description":"Curseur opaque `next_cursor` de la page précédente.","schema":{"type":"string"}}],"responses":{"200":{"description":"Leads du segment.","headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute pour ce jeton.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la fenêtre courante.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la réinitialisation de la fenêtre.","schema":{"type":"integer"}},"X-Request-Id":{"description":"Identifiant de la requête, à communiquer au support.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/List"},{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Lead"}}}}]}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/funnels":{"get":{"operationId":"listFunnels","summary":"Lister les tunnels","description":"Scope requis : `funnels:read`.","tags":["Tunnels"],"security":[{"bearerAuth":[]},{"oauth2":["funnels:read"]}],"x-required-scope":"funnels:read","parameters":[{"name":"limit","in":"query","required":false,"description":"Nombre d’éléments (1 à 100, 25 par défaut).","schema":{"type":"integer","minimum":1,"maximum":100,"default":25}},{"name":"cursor","in":"query","required":false,"description":"Curseur opaque `next_cursor` de la page précédente.","schema":{"type":"string"}},{"name":"status","in":"query","required":false,"description":"Statut.","schema":{"type":"string","enum":["draft","published","paused"]}}],"responses":{"200":{"description":"Tunnels.","headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute pour ce jeton.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la fenêtre courante.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la réinitialisation de la fenêtre.","schema":{"type":"integer"}},"X-Request-Id":{"description":"Identifiant de la requête, à communiquer au support.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/List"},{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Funnel"}}}}]}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/funnels/{id}":{"get":{"operationId":"getFunnel","summary":"Détail d’un tunnel avec statistiques","description":"Scope requis : `funnels:read`.","tags":["Tunnels"],"security":[{"bearerAuth":[]},{"oauth2":["funnels:read"]}],"x-required-scope":"funnels:read","parameters":[{"name":"id","in":"path","required":true,"description":"Identifiant du tunnel.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Tunnel.","headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute pour ce jeton.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la fenêtre courante.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la réinitialisation de la fenêtre.","schema":{"type":"integer"}},"X-Request-Id":{"description":"Identifiant de la requête, à communiquer au support.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Funnel"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/campaigns":{"get":{"operationId":"listCampaigns","summary":"Lister les flux de relance","description":"Scope requis : `campaigns:read`.","tags":["Flux"],"security":[{"bearerAuth":[]},{"oauth2":["campaigns:read"]}],"x-required-scope":"campaigns:read","parameters":[{"name":"limit","in":"query","required":false,"description":"Nombre d’éléments (1 à 100, 25 par défaut).","schema":{"type":"integer","minimum":1,"maximum":100,"default":25}},{"name":"cursor","in":"query","required":false,"description":"Curseur opaque `next_cursor` de la page précédente.","schema":{"type":"string"}},{"name":"status","in":"query","required":false,"description":"Statut.","schema":{"type":"string","enum":["draft","active","paused"]}}],"responses":{"200":{"description":"Flux.","headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute pour ce jeton.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la fenêtre courante.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la réinitialisation de la fenêtre.","schema":{"type":"integer"}},"X-Request-Id":{"description":"Identifiant de la requête, à communiquer au support.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/List"},{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Campaign"}}}}]}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/campaigns/{id}":{"get":{"operationId":"getCampaign","summary":"Détail d’un flux","description":"Scope requis : `campaigns:read`.","tags":["Flux"],"security":[{"bearerAuth":[]},{"oauth2":["campaigns:read"]}],"x-required-scope":"campaigns:read","parameters":[{"name":"id","in":"path","required":true,"description":"Identifiant du flux.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Flux.","headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute pour ce jeton.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la fenêtre courante.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la réinitialisation de la fenêtre.","schema":{"type":"integer"}},"X-Request-Id":{"description":"Identifiant de la requête, à communiquer au support.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Campaign"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/campaigns/{id}/enrollments":{"post":{"operationId":"enrollInCampaign","summary":"Inscrire un lead dans un flux","description":"Planifie la première étape (envoi de messages). Le flux doit être actif, ses canaux inclus dans votre offre et le lead non désinscrit.\n\nScope requis : `campaigns:write`.","tags":["Flux"],"security":[{"bearerAuth":[]},{"oauth2":["campaigns:write"]}],"x-required-scope":"campaigns:write","parameters":[{"name":"id","in":"path","required":true,"description":"Identifiant du flux.","schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Clé unique (≤ 255 caractères) pour rejouer une requête sans effet de bord pendant 24 h. Même clé + corps différent → 409.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnrollmentRequest"}}}},"responses":{"201":{"description":"Inscription planifiée.","headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute pour ce jeton.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la fenêtre courante.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la réinitialisation de la fenêtre.","schema":{"type":"integer"}},"X-Request-Id":{"description":"Identifiant de la requête, à communiquer au support.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampaignEnrollment"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/Invalid"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/journeys":{"get":{"operationId":"listJourneys","summary":"Lister les parcours","description":"Scope requis : `journeys:read`.","tags":["Parcours"],"security":[{"bearerAuth":[]},{"oauth2":["journeys:read"]}],"x-required-scope":"journeys:read","parameters":[{"name":"limit","in":"query","required":false,"description":"Nombre d’éléments (1 à 100, 25 par défaut).","schema":{"type":"integer","minimum":1,"maximum":100,"default":25}},{"name":"cursor","in":"query","required":false,"description":"Curseur opaque `next_cursor` de la page précédente.","schema":{"type":"string"}},{"name":"status","in":"query","required":false,"description":"Statut.","schema":{"type":"string","enum":["draft","active","paused"]}}],"responses":{"200":{"description":"Parcours.","headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute pour ce jeton.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la fenêtre courante.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la réinitialisation de la fenêtre.","schema":{"type":"integer"}},"X-Request-Id":{"description":"Identifiant de la requête, à communiquer au support.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/List"},{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Journey"}}}}]}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/journeys/{id}":{"get":{"operationId":"getJourney","summary":"Détail d’un parcours","description":"Scope requis : `journeys:read`.","tags":["Parcours"],"security":[{"bearerAuth":[]},{"oauth2":["journeys:read"]}],"x-required-scope":"journeys:read","parameters":[{"name":"id","in":"path","required":true,"description":"Identifiant du parcours.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Parcours avec inscriptions par statut.","headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute pour ce jeton.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la fenêtre courante.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la réinitialisation de la fenêtre.","schema":{"type":"integer"}},"X-Request-Id":{"description":"Identifiant de la requête, à communiquer au support.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Journey"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/journeys/{id}/enrollments":{"post":{"operationId":"enrollInJourney","summary":"Inscrire un lead dans un parcours","description":"Uniquement pour un parcours actif ; respecte la règle d’entrée (une fois / plusieurs).\n\nScope requis : `journeys:write`.","tags":["Parcours"],"security":[{"bearerAuth":[]},{"oauth2":["journeys:write"]}],"x-required-scope":"journeys:write","parameters":[{"name":"id","in":"path","required":true,"description":"Identifiant du parcours.","schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Clé unique (≤ 255 caractères) pour rejouer une requête sans effet de bord pendant 24 h. Même clé + corps différent → 409.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnrollmentRequest"}}}},"responses":{"201":{"description":"Inscription créée.","headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute pour ce jeton.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la fenêtre courante.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la réinitialisation de la fenêtre.","schema":{"type":"integer"}},"X-Request-Id":{"description":"Identifiant de la requête, à communiquer au support.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JourneyEnrollment"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/Invalid"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/brands":{"get":{"operationId":"listBrands","summary":"Lister les marques","description":"Scope requis : `social:read`.","tags":["Réseaux sociaux"],"security":[{"bearerAuth":[]},{"oauth2":["social:read"]}],"x-required-scope":"social:read","parameters":[{"name":"limit","in":"query","required":false,"description":"Nombre d’éléments (1 à 100, 25 par défaut).","schema":{"type":"integer","minimum":1,"maximum":100,"default":25}},{"name":"cursor","in":"query","required":false,"description":"Curseur opaque `next_cursor` de la page précédente.","schema":{"type":"string"}}],"responses":{"200":{"description":"Marques.","headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute pour ce jeton.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la fenêtre courante.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la réinitialisation de la fenêtre.","schema":{"type":"integer"}},"X-Request-Id":{"description":"Identifiant de la requête, à communiquer au support.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/List"},{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Brand"}}}}]}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/brands/{id}":{"get":{"operationId":"getBrand","summary":"Détail d’une marque","description":"Scope requis : `social:read`.","tags":["Réseaux sociaux"],"security":[{"bearerAuth":[]},{"oauth2":["social:read"]}],"x-required-scope":"social:read","parameters":[{"name":"id","in":"path","required":true,"description":"Identifiant de la marque.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Marque et comptes connectés.","headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute pour ce jeton.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la fenêtre courante.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la réinitialisation de la fenêtre.","schema":{"type":"integer"}},"X-Request-Id":{"description":"Identifiant de la requête, à communiquer au support.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Brand"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/brands/{id}/strategy":{"get":{"operationId":"getBrandStrategy","summary":"Stratégie éditoriale d’une marque","description":"Scope requis : `social:read`.","tags":["Réseaux sociaux"],"security":[{"bearerAuth":[]},{"oauth2":["social:read"]}],"x-required-scope":"social:read","parameters":[{"name":"id","in":"path","required":true,"description":"Identifiant de la marque.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Stratégie.","headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute pour ce jeton.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la fenêtre courante.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la réinitialisation de la fenêtre.","schema":{"type":"integer"}},"X-Request-Id":{"description":"Identifiant de la requête, à communiquer au support.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SocialStrategy"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/social/posts":{"get":{"operationId":"listSocialPosts","summary":"Lister les publications","description":"Scope requis : `social:read`.","tags":["Réseaux sociaux"],"security":[{"bearerAuth":[]},{"oauth2":["social:read"]}],"x-required-scope":"social:read","parameters":[{"name":"limit","in":"query","required":false,"description":"Nombre d’éléments (1 à 100, 25 par défaut).","schema":{"type":"integer","minimum":1,"maximum":100,"default":25}},{"name":"cursor","in":"query","required":false,"description":"Curseur opaque `next_cursor` de la page précédente.","schema":{"type":"string"}},{"name":"brand_id","in":"query","required":false,"description":"Marque.","schema":{"type":"string","format":"uuid"}},{"name":"status","in":"query","required":false,"description":"Statut.","schema":{"type":"string","enum":["draft","pending_approval","approved","scheduled","publishing","published","partially_published","failed","canceled"]}},{"name":"from","in":"query","required":false,"description":"Date de planification / publication minimale.","schema":{"type":"string","format":"date-time"}},{"name":"to","in":"query","required":false,"description":"Date maximale.","schema":{"type":"string","format":"date-time"}}],"responses":{"200":{"description":"Publications.","headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute pour ce jeton.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la fenêtre courante.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la réinitialisation de la fenêtre.","schema":{"type":"integer"}},"X-Request-Id":{"description":"Identifiant de la requête, à communiquer au support.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/List"},{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/SocialPost"}}}}]}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/Invalid"},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"post":{"operationId":"createSocialPost","summary":"Créer une publication","description":"Sans `social:publish`, une demande de planification devient une soumission pour validation par l’équipe (`pending_approval`).\n\nScope requis : `social:write`.","tags":["Réseaux sociaux"],"security":[{"bearerAuth":[]},{"oauth2":["social:write"]}],"x-required-scope":"social:write","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Clé unique (≤ 255 caractères) pour rejouer une requête sans effet de bord pendant 24 h. Même clé + corps différent → 409.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SocialPostCreate"}}}},"responses":{"201":{"description":"Publication créée.","headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute pour ce jeton.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la fenêtre courante.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la réinitialisation de la fenêtre.","schema":{"type":"integer"}},"X-Request-Id":{"description":"Identifiant de la requête, à communiquer au support.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SocialPost"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/Invalid"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/social/posts/{id}":{"get":{"operationId":"getSocialPost","summary":"Détail d’une publication","description":"Scope requis : `social:read`.","tags":["Réseaux sociaux"],"security":[{"bearerAuth":[]},{"oauth2":["social:read"]}],"x-required-scope":"social:read","parameters":[{"name":"id","in":"path","required":true,"description":"Identifiant de la publication.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Publication.","headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute pour ce jeton.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la fenêtre courante.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la réinitialisation de la fenêtre.","schema":{"type":"integer"}},"X-Request-Id":{"description":"Identifiant de la requête, à communiquer au support.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SocialPost"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"patch":{"operationId":"updateSocialPost","summary":"Modifier une publication","description":"Scope requis : `social:write`.","tags":["Réseaux sociaux"],"security":[{"bearerAuth":[]},{"oauth2":["social:write"]}],"x-required-scope":"social:write","parameters":[{"name":"id","in":"path","required":true,"description":"Identifiant de la publication.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SocialPostUpdate"}}}},"responses":{"200":{"description":"Publication modifiée.","headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute pour ce jeton.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la fenêtre courante.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la réinitialisation de la fenêtre.","schema":{"type":"integer"}},"X-Request-Id":{"description":"Identifiant de la requête, à communiquer au support.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SocialPost"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/Invalid"},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"delete":{"operationId":"deleteSocialPost","summary":"Supprimer un brouillon","description":"Scope requis : `social:write`.","tags":["Réseaux sociaux"],"security":[{"bearerAuth":[]},{"oauth2":["social:write"]}],"x-required-scope":"social:write","parameters":[{"name":"id","in":"path","required":true,"description":"Identifiant de la publication.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Publication supprimée.","headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute pour ce jeton.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la fenêtre courante.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la réinitialisation de la fenêtre.","schema":{"type":"integer"}},"X-Request-Id":{"description":"Identifiant de la requête, à communiquer au support.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Deleted"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/social/posts/{id}/submit":{"post":{"operationId":"submitSocialPost","summary":"Soumettre pour validation","description":"Scope requis : `social:write`.","tags":["Réseaux sociaux"],"security":[{"bearerAuth":[]},{"oauth2":["social:write"]}],"x-required-scope":"social:write","parameters":[{"name":"id","in":"path","required":true,"description":"Identifiant de la publication.","schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Clé unique (≤ 255 caractères) pour rejouer une requête sans effet de bord pendant 24 h. Même clé + corps différent → 409.","schema":{"type":"string","maxLength":255}}],"responses":{"200":{"description":"Publication à valider.","headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute pour ce jeton.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la fenêtre courante.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la réinitialisation de la fenêtre.","schema":{"type":"integer"}},"X-Request-Id":{"description":"Identifiant de la requête, à communiquer au support.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SocialPost"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/social/posts/{id}/schedule":{"post":{"operationId":"scheduleSocialPost","summary":"Planifier une publication","description":"Exige aussi des droits de gestion sur l’espace (propriétaire / administrateur).\n\nScope requis : `social:publish`.","tags":["Réseaux sociaux"],"security":[{"bearerAuth":[]},{"oauth2":["social:publish"]}],"x-required-scope":"social:publish","parameters":[{"name":"id","in":"path","required":true,"description":"Identifiant de la publication.","schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Clé unique (≤ 255 caractères) pour rejouer une requête sans effet de bord pendant 24 h. Même clé + corps différent → 409.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScheduleRequest"}}}},"responses":{"200":{"description":"Publication planifiée.","headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute pour ce jeton.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la fenêtre courante.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la réinitialisation de la fenêtre.","schema":{"type":"integer"}},"X-Request-Id":{"description":"Identifiant de la requête, à communiquer au support.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SocialPost"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/Invalid"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/social/posts/{id}/publish":{"post":{"operationId":"publishSocialPost","summary":"Publier immédiatement","description":"Scope requis : `social:publish`.","tags":["Réseaux sociaux"],"security":[{"bearerAuth":[]},{"oauth2":["social:publish"]}],"x-required-scope":"social:publish","parameters":[{"name":"id","in":"path","required":true,"description":"Identifiant de la publication.","schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Clé unique (≤ 255 caractères) pour rejouer une requête sans effet de bord pendant 24 h. Même clé + corps différent → 409.","schema":{"type":"string","maxLength":255}}],"responses":{"200":{"description":"Publication en cours.","headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute pour ce jeton.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la fenêtre courante.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la réinitialisation de la fenêtre.","schema":{"type":"integer"}},"X-Request-Id":{"description":"Identifiant de la requête, à communiquer au support.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SocialPost"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/Invalid"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/payments":{"get":{"operationId":"listPayments","summary":"Lister les ventes des tunnels","description":"Scope requis : `payments:read`.","tags":["Paiements"],"security":[{"bearerAuth":[]},{"oauth2":["payments:read"]}],"x-required-scope":"payments:read","parameters":[{"name":"limit","in":"query","required":false,"description":"Nombre d’éléments (1 à 100, 25 par défaut).","schema":{"type":"integer","minimum":1,"maximum":100,"default":25}},{"name":"cursor","in":"query","required":false,"description":"Curseur opaque `next_cursor` de la page précédente.","schema":{"type":"string"}},{"name":"status","in":"query","required":false,"description":"Statut.","schema":{"type":"string","enum":["pending","succeeded","failed"]}},{"name":"funnel_id","in":"query","required":false,"description":"Tunnel.","schema":{"type":"string","format":"uuid"}},{"name":"lead_id","in":"query","required":false,"description":"Acheteur.","schema":{"type":"string","format":"uuid"}},{"name":"created_after","in":"query","required":false,"description":"À partir de.","schema":{"type":"string","format":"date-time"}},{"name":"created_before","in":"query","required":false,"description":"Avant.","schema":{"type":"string","format":"date-time"}}],"responses":{"200":{"description":"Paiements.","headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute pour ce jeton.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la fenêtre courante.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la réinitialisation de la fenêtre.","schema":{"type":"integer"}},"X-Request-Id":{"description":"Identifiant de la requête, à communiquer au support.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/List"},{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Payment"}}}}]}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"422":{"$ref":"#/components/responses/Invalid"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/webhook_endpoints":{"get":{"operationId":"listWebhookEndpoints","summary":"Lister les points de terminaison","description":"Scope requis : `webhooks:manage`.","tags":["Webhooks"],"security":[{"bearerAuth":[]},{"oauth2":["webhooks:manage"]}],"x-required-scope":"webhooks:manage","parameters":[{"name":"limit","in":"query","required":false,"description":"Nombre d’éléments (1 à 100, 25 par défaut).","schema":{"type":"integer","minimum":1,"maximum":100,"default":25}},{"name":"cursor","in":"query","required":false,"description":"Curseur opaque `next_cursor` de la page précédente.","schema":{"type":"string"}}],"responses":{"200":{"description":"Points de terminaison.","headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute pour ce jeton.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la fenêtre courante.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la réinitialisation de la fenêtre.","schema":{"type":"integer"}},"X-Request-Id":{"description":"Identifiant de la requête, à communiquer au support.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/List"},{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/WebhookEndpoint"}}}}]}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"post":{"operationId":"createWebhookEndpoint","summary":"Créer un point de terminaison","description":"Le secret de signature n’est renvoyé qu’à la création.\n\nScope requis : `webhooks:manage`.","tags":["Webhooks"],"security":[{"bearerAuth":[]},{"oauth2":["webhooks:manage"]}],"x-required-scope":"webhooks:manage","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Clé unique (≤ 255 caractères) pour rejouer une requête sans effet de bord pendant 24 h. Même clé + corps différent → 409.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpointCreate"}}}},"responses":{"201":{"description":"Créé.","headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute pour ce jeton.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la fenêtre courante.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la réinitialisation de la fenêtre.","schema":{"type":"integer"}},"X-Request-Id":{"description":"Identifiant de la requête, à communiquer au support.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpointWithSecret"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/Invalid"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/webhook_endpoints/{id}":{"get":{"operationId":"getWebhookEndpoint","summary":"Détail d’un point de terminaison","description":"Scope requis : `webhooks:manage`.","tags":["Webhooks"],"security":[{"bearerAuth":[]},{"oauth2":["webhooks:manage"]}],"x-required-scope":"webhooks:manage","parameters":[{"name":"id","in":"path","required":true,"description":"Identifiant du point de terminaison.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Point de terminaison.","headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute pour ce jeton.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la fenêtre courante.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la réinitialisation de la fenêtre.","schema":{"type":"integer"}},"X-Request-Id":{"description":"Identifiant de la requête, à communiquer au support.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpoint"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"patch":{"operationId":"updateWebhookEndpoint","summary":"Modifier un point de terminaison","description":"Scope requis : `webhooks:manage`.","tags":["Webhooks"],"security":[{"bearerAuth":[]},{"oauth2":["webhooks:manage"]}],"x-required-scope":"webhooks:manage","parameters":[{"name":"id","in":"path","required":true,"description":"Identifiant du point de terminaison.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpointUpdate"}}}},"responses":{"200":{"description":"Modifié.","headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute pour ce jeton.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la fenêtre courante.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la réinitialisation de la fenêtre.","schema":{"type":"integer"}},"X-Request-Id":{"description":"Identifiant de la requête, à communiquer au support.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpoint"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/Invalid"},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"delete":{"operationId":"deleteWebhookEndpoint","summary":"Supprimer un point de terminaison","description":"Scope requis : `webhooks:manage`.","tags":["Webhooks"],"security":[{"bearerAuth":[]},{"oauth2":["webhooks:manage"]}],"x-required-scope":"webhooks:manage","parameters":[{"name":"id","in":"path","required":true,"description":"Identifiant du point de terminaison.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Supprimé.","headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute pour ce jeton.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la fenêtre courante.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la réinitialisation de la fenêtre.","schema":{"type":"integer"}},"X-Request-Id":{"description":"Identifiant de la requête, à communiquer au support.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Deleted"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/webhook_endpoints/{id}/rotate_secret":{"post":{"operationId":"rotateWebhookSecret","summary":"Renouveler le secret","description":"L’ancien secret reste valide 24 h (les deux signatures sont envoyées).\n\nScope requis : `webhooks:manage`.","tags":["Webhooks"],"security":[{"bearerAuth":[]},{"oauth2":["webhooks:manage"]}],"x-required-scope":"webhooks:manage","parameters":[{"name":"id","in":"path","required":true,"description":"Identifiant du point de terminaison.","schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Clé unique (≤ 255 caractères) pour rejouer une requête sans effet de bord pendant 24 h. Même clé + corps différent → 409.","schema":{"type":"string","maxLength":255}}],"responses":{"200":{"description":"Nouveau secret.","headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute pour ce jeton.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la fenêtre courante.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la réinitialisation de la fenêtre.","schema":{"type":"integer"}},"X-Request-Id":{"description":"Identifiant de la requête, à communiquer au support.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpointWithSecret"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/webhook_endpoints/{id}/test":{"post":{"operationId":"testWebhookEndpoint","summary":"Envoyer un événement ping","description":"Scope requis : `webhooks:manage`.","tags":["Webhooks"],"security":[{"bearerAuth":[]},{"oauth2":["webhooks:manage"]}],"x-required-scope":"webhooks:manage","parameters":[{"name":"id","in":"path","required":true,"description":"Identifiant du point de terminaison.","schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Clé unique (≤ 255 caractères) pour rejouer une requête sans effet de bord pendant 24 h. Même clé + corps différent → 409.","schema":{"type":"string","maxLength":255}}],"responses":{"202":{"description":"Livraison créée.","headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute pour ce jeton.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la fenêtre courante.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la réinitialisation de la fenêtre.","schema":{"type":"integer"}},"X-Request-Id":{"description":"Identifiant de la requête, à communiquer au support.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookDelivery"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/webhook_endpoints/{id}/deliveries":{"get":{"operationId":"listWebhookDeliveries","summary":"Historique des livraisons","description":"Scope requis : `webhooks:manage`.","tags":["Webhooks"],"security":[{"bearerAuth":[]},{"oauth2":["webhooks:manage"]}],"x-required-scope":"webhooks:manage","parameters":[{"name":"id","in":"path","required":true,"description":"Identifiant du point de terminaison.","schema":{"type":"string","format":"uuid"}},{"name":"limit","in":"query","required":false,"description":"Nombre d’éléments (1 à 100, 25 par défaut).","schema":{"type":"integer","minimum":1,"maximum":100,"default":25}},{"name":"cursor","in":"query","required":false,"description":"Curseur opaque `next_cursor` de la page précédente.","schema":{"type":"string"}}],"responses":{"200":{"description":"Livraisons.","headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute pour ce jeton.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la fenêtre courante.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la réinitialisation de la fenêtre.","schema":{"type":"integer"}},"X-Request-Id":{"description":"Identifiant de la requête, à communiquer au support.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/List"},{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/WebhookDelivery"}}}}]}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/webhook_deliveries/{id}/retry":{"post":{"operationId":"retryWebhookDelivery","summary":"Relancer une livraison","description":"Scope requis : `webhooks:manage`.","tags":["Webhooks"],"security":[{"bearerAuth":[]},{"oauth2":["webhooks:manage"]}],"x-required-scope":"webhooks:manage","parameters":[{"name":"id","in":"path","required":true,"description":"Identifiant de la livraison.","schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Clé unique (≤ 255 caractères) pour rejouer une requête sans effet de bord pendant 24 h. Même clé + corps différent → 409.","schema":{"type":"string","maxLength":255}}],"responses":{"202":{"description":"Livraison relancée.","headers":{"RateLimit-Limit":{"description":"Requêtes autorisées par minute pour ce jeton.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la fenêtre courante.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la réinitialisation de la fenêtre.","schema":{"type":"integer"}},"X-Request-Id":{"description":"Identifiant de la requête, à communiquer au support.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookDelivery"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}}},"webhooks":{"event":{"post":{"summary":"Événement envoyé à vos points de terminaison","description":"En-têtes : Strike-Event-Id, Strike-Event-Type, Strike-Delivery-Id et Strike-Signature `t=<unix>,v1=<HMAC-SHA256(secret, \"<t>.<corps brut>\")>`. Rejetez les messages dont |maintenant − t| > 300 s. Répondez 2xx en moins de 10 s ; les erreurs réseau, 5xx et 429 sont retentées pendant environ 21 h.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEvent"}}}},"responses":{"200":{"description":"Événement reçu."}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Clé API (`sk_live_…`) créée dans Dashboard → Développeurs → Clés API."},"oauth2":{"type":"oauth2","description":"OAuth 2.1 avec PKCE (S256) obligatoire et enregistrement dynamique des clients (RFC 7591), pour les agents IA.","flows":{"authorizationCode":{"authorizationUrl":"https://strikespace.net/oauth/authorize","tokenUrl":"https://strikespace.net/oauth/token","refreshUrl":"https://strikespace.net/oauth/token","scopes":{"leads:read":"Lire les leads","leads:write":"Créer, modifier et supprimer des leads","events:read":"Lire les événements de tracking","events:write":"Envoyer des événements de tracking","segments:read":"Lire les segments et leurs membres","funnels:read":"Lire les tunnels et leurs statistiques","campaigns:read":"Lire les flux de relance","campaigns:write":"Inscrire des leads dans un flux (envoi de messages)","journeys:read":"Lire les parcours","journeys:write":"Inscrire des leads dans un parcours","social:read":"Lire les marques, publications et stratégies","social:write":"Créer et modifier des publications (brouillons, validation)","social:publish":"Planifier et publier sur les réseaux sociaux","payments:read":"Lire les paiements des tunnels","webhooks:manage":"Gérer les webhooks"}}}}},"schemas":{"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","description":"Catégorie de l’erreur.","enum":["invalid_request","authentication_error","permission_error","not_found","conflict","rate_limit","internal"]},"message":{"type":"string","description":"Message lisible (en français)."},"code":{"type":"string","description":"Code précis : insufficient_scope, plan_required, ip_not_allowed, quota_exceeded, channel_not_in_plan, idempotency_key_reused, rate_limited…"},"param":{"type":"string","description":"Champ en cause (erreurs de validation)."},"request_id":{"type":"string","description":"Identifiant de la requête."}},"required":["type","message"]}},"required":["error"]},"List":{"type":"object","properties":{"object":{"type":"string","const":"list"},"data":{"type":"array","items":{}},"has_more":{"type":"boolean"},"next_cursor":{"anyOf":[{"type":"string","description":"À passer en `cursor` pour la page suivante."},{"type":"null"}]}},"required":["object","data","has_more","next_cursor"]},"Workspace":{"type":"object","properties":{"object":{"type":"string","const":"workspace"},"id":{"type":"string","description":"Identifiant de l’espace (propriétaire).","format":"uuid"},"name":{"type":"string"},"plan":{"type":"string","description":"Offre","enum":["free","starter","pro","enterprise"]},"scopes":{"type":"array","items":{"type":"string"}},"principal":{"type":"object","properties":{"kind":{"type":"string","enum":["api_key","oauth"]},"id":{"type":"string","format":"uuid"},"label":{"type":"string","description":"Nom de la clé ou de l’agent."},"role":{"type":"string"}}},"limits":{"anyOf":[{"type":"object","properties":{"requests_per_minute":{"type":"integer"},"requests_per_day":{"type":"integer"},"api_keys":{"type":"integer"},"webhook_endpoints":{"type":"integer"},"connected_agents":{"type":"integer"}}},{"type":"null"}]}}},"Lead":{"type":"object","properties":{"object":{"type":"string","const":"lead"},"id":{"type":"string","format":"uuid"},"first_name":{"type":"string"},"email":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}]},"phone_number":{"anyOf":[{"type":"string","description":"Format international (+229…)."},{"type":"null"}]},"country_code":{"type":"string","description":"Code pays ISO 3166-1 alpha-2."},"preferred_channel":{"type":"string","enum":["whatsapp","email","sms"]},"status":{"type":"string","enum":["cold","warm","converted","blacklisted"]},"funnel_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"traits":{"type":"object","additionalProperties":true,"description":"Attributs libres."},"unsubscribed":{"type":"boolean"},"unsubscribed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"created_at":{"type":"string","format":"date-time"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}}},"LeadUpsert":{"type":"object","properties":{"first_name":{"type":"string","maxLength":100},"email":{"type":"string","description":"Clé de rapprochement prioritaire.","format":"email","maxLength":254},"phone_number":{"type":"string","description":"Format international, ex. +22997000000.","pattern":"^\\+[1-9]\\d{6,14}$"},"country_code":{"type":"string","pattern":"^[A-Za-z]{2}$"},"preferred_channel":{"type":"string","description":"Doit être inclus dans votre offre.","enum":["whatsapp","email","sms"]},"status":{"type":"string","enum":["cold","warm","converted","blacklisted"]},"funnel_id":{"type":"string","format":"uuid"},"traits":{"type":"object","additionalProperties":true,"description":"Fusion superficielle avec les attributs existants (≤ 16 Ko)."}}},"LeadUpdate":{"type":"object","properties":{"first_name":{"type":"string","maxLength":100},"email":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}]},"phone_number":{"anyOf":[{"type":"string"},{"type":"null"}]},"country_code":{"type":"string"},"preferred_channel":{"type":"string","enum":["whatsapp","email","sms"]},"status":{"type":"string","enum":["cold","warm","converted","blacklisted"]},"traits":{"type":"object","additionalProperties":true,"description":"Fusion superficielle (≤ 16 Ko)."}}},"Deleted":{"type":"object","properties":{"object":{"type":"string"},"id":{"type":"string"},"deleted":{"type":"boolean","const":true}}},"Event":{"type":"object","properties":{"object":{"type":"string","const":"event"},"id":{"type":"string"},"name":{"type":"string"},"lead_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"anonymous_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"properties":{"type":"object","additionalProperties":true,"description":"Propriétés de l’événement."},"message_id":{"type":"string"},"timestamp":{"type":"string","format":"date-time"},"received_at":{"type":"string","format":"date-time"}}},"EventCreate":{"type":"object","properties":{"name":{"type":"string","description":"Nom de l’événement (lettres, chiffres, . : - _ et espaces).","maxLength":128},"lead_id":{"type":"string","format":"uuid"},"email":{"type":"string","format":"email"},"phone_number":{"type":"string"},"anonymous_id":{"type":"string","maxLength":64},"properties":{"type":"object","additionalProperties":true,"description":"≤ 16 Ko."},"timestamp":{"type":"string","description":"Date de l’événement (par défaut : maintenant).","format":"date-time"},"message_id":{"type":"string","description":"Déduplication : un même message_id n’est enregistré qu’une fois.","maxLength":64}},"required":["name"]},"EventAccepted":{"type":"object","properties":{"object":{"type":"string","const":"event"},"status":{"type":"string","const":"accepted"},"name":{"type":"string"},"lead_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"anonymous_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"message_id":{"type":"string"},"timestamp":{"type":"string","format":"date-time"}}},"Segment":{"type":"object","properties":{"object":{"type":"string","const":"segment"},"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"definition":{"type":"object","additionalProperties":true,"description":"Définition du segment (DSL STRIKE)."},"lead_count":{"type":"integer","description":"Nombre de leads (détail uniquement, calculé en direct)."},"created_at":{"type":"string","format":"date-time"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}}},"Funnel":{"type":"object","properties":{"object":{"type":"string","const":"funnel"},"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"slug":{"type":"string"},"status":{"type":"string","enum":["draft","published","paused"]},"template":{"type":"string"},"url":{"type":"string","description":"Page publique.","format":"uri"},"headline":{"type":"string"},"product_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"product_price":{"anyOf":[{"type":"integer"},{"type":"null"}]},"currency":{"type":"string","const":"XOF"},"campaign_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"stats":{"type":"object","properties":{"leads":{"type":"integer"},"converted_leads":{"type":"integer"},"conversion_rate":{"type":"number"},"payments_succeeded":{"type":"integer"},"revenue":{"type":"integer"},"currency":{"type":"string"}}},"created_at":{"type":"string","format":"date-time"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}}},"Campaign":{"type":"object","properties":{"object":{"type":"string","const":"campaign"},"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"flow_type":{"type":"string","enum":["direct_response","click_to_chat","lead_magnet","outbound_b2b","webinar"]},"status":{"type":"string","enum":["draft","active","paused"]},"steps":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"order":{"type":"integer"},"channel":{"type":"string","enum":["whatsapp","email","sms"]},"delay_minutes":{"type":"integer"},"content_template":{"type":"string"}}}},"created_at":{"type":"string","format":"date-time"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}}},"CampaignEnrollment":{"type":"object","properties":{"object":{"type":"string","const":"campaign_enrollment"},"campaign_id":{"type":"string","format":"uuid"},"lead_id":{"type":"string","format":"uuid"},"status":{"type":"string","const":"scheduled"},"first_step_at":{"type":"string","format":"date-time"}}},"EnrollmentRequest":{"type":"object","properties":{"lead_id":{"type":"string","format":"uuid"}},"required":["lead_id"]},"Journey":{"type":"object","properties":{"object":{"type":"string","const":"journey"},"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"status":{"type":"string","enum":["draft","active","paused"]},"trigger":{"type":"object","properties":{"type":{"anyOf":[{"type":"string","enum":["event","segment"]},{"type":"null"}]},"event":{"anyOf":[{"type":"string"},{"type":"null"}]},"segment_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]}}},"entry_policy":{"type":"string","enum":["once","multiple"]},"version":{"type":"integer"},"enrollments":{"type":"object","additionalProperties":true,"description":"Inscriptions par statut (détail uniquement)."},"activated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"created_at":{"type":"string","format":"date-time"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}}},"JourneyEnrollment":{"type":"object","properties":{"object":{"type":"string","const":"journey_enrollment"},"id":{"type":"string","format":"uuid"},"journey_id":{"type":"string","format":"uuid"},"lead_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["active","waiting","completed","failed","exited"]},"current_node_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"step":{"type":"integer"},"started_at":{"type":"string","format":"date-time"},"completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}}},"SocialAccount":{"type":"object","properties":{"object":{"type":"string","const":"social_account"},"id":{"type":"string","format":"uuid"},"provider":{"type":"string","enum":["facebook","instagram","tiktok","linkedin","x"]},"display_name":{"type":"string"},"username":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string","enum":["connected","expired","revoked","error"]}}},"Brand":{"type":"object","properties":{"object":{"type":"string","const":"brand"},"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"slug":{"type":"string"},"logo_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"timezone":{"type":"string"},"language":{"type":"string"},"industry":{"anyOf":[{"type":"string"},{"type":"null"}]},"website":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"tone":{"anyOf":[{"type":"string"},{"type":"null"}]},"audience":{"anyOf":[{"type":"string"},{"type":"null"}]},"hashtags":{"type":"array","items":{"type":"string"}},"accounts":{"type":"array","items":{"$ref":"#/components/schemas/SocialAccount"}},"created_at":{"type":"string","format":"date-time"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}}},"SocialStrategy":{"type":"object","properties":{"object":{"type":"string","const":"social_strategy"},"id":{"type":"string","format":"uuid"},"brand_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["draft","active"]},"goals":{"anyOf":[{"type":"string"},{"type":"null"}]},"pillars":{"type":"array","items":{"type":"object","additionalProperties":true,"description":"Pilier éditorial."}},"cadence":{"type":"object","additionalProperties":true,"description":"Rythme de publication."},"plan":{"type":"array","items":{"type":"object","additionalProperties":true,"description":"Idée du plan sur 30 jours."}},"generated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"created_at":{"type":"string","format":"date-time"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}}},"Media":{"type":"object","properties":{"url":{"type":"string","description":"URL HTTPS publique.","format":"uri","maxLength":600},"type":{"type":"string","enum":["image","video"]}},"required":["url","type"]},"SocialPost":{"type":"object","properties":{"object":{"type":"string","const":"social_post"},"id":{"type":"string","format":"uuid"},"brand_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["draft","pending_approval","approved","scheduled","publishing","published","partially_published","failed","canceled"]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"body":{"type":"string"},"media":{"type":"array","items":{"$ref":"#/components/schemas/Media"}},"link_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"overrides":{"type":"object","additionalProperties":true,"description":"Texte spécifique par réseau : { \"instagram\": { \"body\": \"…\" } }."},"pillar":{"anyOf":[{"type":"string"},{"type":"null"}]},"scheduled_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"published_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"approved_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"author_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"approved_by":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"rejected_reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"targets":{"type":"array","items":{"type":"object","properties":{"account_id":{"type":"string","format":"uuid"},"provider":{"type":"string","enum":["facebook","instagram","tiktok","linkedin","x"]},"status":{"type":"string","enum":["pending","publishing","published","failed","skipped"]},"permalink":{"anyOf":[{"type":"string"},{"type":"null"}]},"external_post_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"error":{"anyOf":[{"type":"string"},{"type":"null"}]},"published_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}}}},"version":{"type":"integer","description":"Version, à renvoyer en `base_version` pour éviter les écrasements."},"notice":{"type":"string","description":"Présent quand l’action demandée a été transformée en soumission."},"created_at":{"type":"string","format":"date-time"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}}},"SocialPostCreate":{"type":"object","properties":{"brand_id":{"type":"string","format":"uuid"},"body":{"type":"string","maxLength":70000},"title":{"anyOf":[{"type":"string","maxLength":160},{"type":"null"}]},"account_ids":{"type":"array","items":{"type":"string","format":"uuid"},"maxItems":50},"media":{"type":"array","items":{"$ref":"#/components/schemas/Media"},"maxItems":20},"link_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"overrides":{"type":"object","additionalProperties":true,"description":"Texte par réseau."},"pillar":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}]},"scheduled_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"action":{"type":"string","description":"draft (défaut), submit (validation par l’équipe) ou schedule (exige social:publish et des droits de gestion ; sinon la publication est soumise pour validation).","enum":["draft","submit","schedule"]}},"required":["brand_id","body"]},"SocialPostUpdate":{"type":"object","properties":{"body":{"type":"string","maxLength":70000},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"account_ids":{"type":"array","items":{"type":"string","format":"uuid"}},"media":{"type":"array","items":{"$ref":"#/components/schemas/Media"}},"link_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"overrides":{"type":"object","additionalProperties":true,"description":"Texte par réseau."},"pillar":{"anyOf":[{"type":"string"},{"type":"null"}]},"scheduled_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"base_version":{"type":"integer","description":"Version connue ; 409 si la publication a changé entre-temps."}}},"ScheduleRequest":{"type":"object","properties":{"scheduled_at":{"type":"string","description":"Date future (ISO 8601).","format":"date-time"}},"required":["scheduled_at"]},"Payment":{"type":"object","properties":{"object":{"type":"string","const":"payment"},"id":{"type":"string","format":"uuid"},"amount":{"type":"integer","description":"Montant en unités de la devise (FCFA)."},"currency":{"type":"string","const":"XOF"},"status":{"type":"string","enum":["pending","succeeded","failed"]},"provider":{"type":"string"},"reference":{"type":"string"},"funnel_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"lead_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"created_at":{"type":"string","format":"date-time"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}}},"WebhookEndpoint":{"type":"object","properties":{"object":{"type":"string","const":"webhook_endpoint"},"id":{"type":"string","format":"uuid"},"url":{"type":"string","format":"uri"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"events":{"type":"array","items":{"type":"string","enum":["lead.created","lead.updated","lead.converted","lead.deleted","event.tracked","payment.succeeded","payment.failed","journey.enrollment.created","journey.enrollment.completed","social.post.pending_approval","social.post.scheduled","social.post.published","social.post.failed","ping","*"]}},"status":{"type":"string","enum":["active","disabled"]},"disabled_reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"last_delivery_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"created_at":{"type":"string","format":"date-time"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}}},"WebhookEndpointWithSecret":{"allOf":[{"$ref":"#/components/schemas/WebhookEndpoint"},{"type":"object","properties":{"secret":{"type":"string","description":"Secret de signature `whsec_…`, affiché une seule fois."}}}]},"WebhookEndpointCreate":{"type":"object","properties":{"url":{"type":"string","description":"HTTPS obligatoire en production.","format":"uri"},"description":{"type":"string","maxLength":500},"events":{"type":"array","items":{"type":"string","enum":["lead.created","lead.updated","lead.converted","lead.deleted","event.tracked","payment.succeeded","payment.failed","journey.enrollment.created","journey.enrollment.completed","social.post.pending_approval","social.post.scheduled","social.post.published","social.post.failed","ping","*"]},"description":"`*` = tous les événements sauf event.tracked (opt-in)."}},"required":["url","events"]},"WebhookEndpointUpdate":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"events":{"type":"array","items":{"type":"string"}},"status":{"type":"string","enum":["active","disabled"]}}},"WebhookDelivery":{"type":"object","properties":{"object":{"type":"string","const":"webhook_delivery"},"id":{"type":"string","format":"uuid"},"endpoint_id":{"type":"string","format":"uuid"},"event_id":{"type":"string"},"event_type":{"type":"string"},"status":{"type":"string","enum":["pending","succeeded","failed"]},"attempts":{"type":"integer"},"response_status":{"anyOf":[{"type":"integer"},{"type":"null"}]},"error":{"anyOf":[{"type":"string"},{"type":"null"}]},"next_attempt_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"delivered_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"created_at":{"type":"string","format":"date-time"}}},"WebhookEvent":{"type":"object","properties":{"id":{"type":"string","description":"evt_…"},"object":{"type":"string","const":"event"},"type":{"type":"string","enum":["lead.created","lead.updated","lead.converted","lead.deleted","event.tracked","payment.succeeded","payment.failed","journey.enrollment.created","journey.enrollment.completed","social.post.pending_approval","social.post.scheduled","social.post.published","social.post.failed","ping"]},"created_at":{"type":"string","format":"date-time"},"api_version":{"type":"string","const":"2026-10-01"},"workspace_id":{"type":"string","format":"uuid"},"data":{"type":"object","properties":{"object":{"type":"object","additionalProperties":true,"description":"Objet concerné, même format que l’API REST."}}}}}},"responses":{"Unauthorized":{"description":"Jeton absent, invalide, expiré ou révoqué.","headers":{"WWW-Authenticate":{"description":"Bearer resource_metadata=\"…/.well-known/oauth-protected-resource\"","schema":{"type":"string"}},"X-Request-Id":{"description":"Identifiant de la requête, à communiquer au support.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Forbidden":{"description":"Permission manquante (insufficient_scope), offre insuffisante (plan_required) ou IP non autorisée (ip_not_allowed).","headers":{"X-Request-Id":{"description":"Identifiant de la requête, à communiquer au support.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"NotFound":{"description":"Ressource introuvable dans votre espace.","headers":{"X-Request-Id":{"description":"Identifiant de la requête, à communiquer au support.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Conflict":{"description":"Conflit (état, doublon ou Idempotency-Key réutilisée).","headers":{"X-Request-Id":{"description":"Identifiant de la requête, à communiquer au support.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Invalid":{"description":"Requête invalide ; `param` indique le champ.","headers":{"X-Request-Id":{"description":"Identifiant de la requête, à communiquer au support.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"TooManyRequests":{"description":"Limite de requêtes atteinte.","headers":{"Retry-After":{"description":"Secondes à attendre.","schema":{"type":"integer"}},"RateLimit-Limit":{"description":"Requêtes autorisées par minute pour ce jeton.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la fenêtre courante.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la réinitialisation de la fenêtre.","schema":{"type":"integer"}},"X-Request-Id":{"description":"Identifiant de la requête, à communiquer au support.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}