GET /client/export-data

Cet endpoint matérialise le droit à la portabilité prévu par le RGPD article 20 et la déclaration “Privacy by design” Actero. Il retourne en un seul appel les données stockées sur la boutique demandée, prêtes à être archivées ou migrées chez un autre prestataire. Les très gros volumes peuvent être exportés en partie : voir Performance et taille. Voir Export RGPD pour le contexte légal et opérationnel.

GET https://actero.fr/api/client/export-data?format=json&client_id=<boutique>
GET https://actero.fr/api/client/export-data?format=csv&client_id=<boutique>

Authentification

Authorization: Bearer <jwt> : le jeton de session Supabase de la personne connectée (celui du dashboard, valable 1 h, qu’on lit avec supabase.auth.getSession() dans le navigateur connecté).

Un jeton développeur mcp_pat_… (page IA et API) n’ouvre que le serveur MCP : il répond 401 ici. Une clé ak_… (publique, celle de la bulle) n’ouvre pas non plus cette route. Pour un export automatisé, l’écran Paramètres → Exporter tes données reste le plus simple.

Qui peut exporter :

le propriétaire de la boutique, ou un manager : un membre support, finance ou opérationnel reçoit 403, même en appelant la route directement ;
un administrateur Actero.

La boutique se passe en client_id. Sans client_id, l’export ne marche que si le compte n’a qu’une seule boutique ; avec plusieurs boutiques, la route répond 400 et demande de préciser laquelle. Si le compte n’est lié à aucune boutique → 403 Aucune boutique associée à ce compte.

Query params

enum

default:"json"

json (défaut) ou csv. Le CSV concatène toutes les tables en un seul fichier avec des sections ## table_name (count) pour pouvoir l’ouvrir dans Excel ou LibreOffice (BOM UTF-8 inclus).

string

Identifiant de la boutique à exporter. Obligatoire si ton compte a plusieurs boutiques. Il n’existe aucun paramètre de période : l’export contient tout l’historique.

Headers

Header	Valeur	Requis
`Authorization`	`Bearer <token>`	Oui

Response — `200 OK`

Format JSON

Content-Type: application/json; charset=utf-8 Content-Disposition: attachment; filename="actero-export-2026-04-22T10-00-00.json"

{
  "exported_at": "2026-04-22T10:00:00.000Z",
  "client_id": "01HX2Y...",
  "client": [ { "id": "01HX...", "brand_name": "Mon Shop", "plan": "pro", ... } ],
  "settings": [ ... ],
  "integrations": [
    { "id": "int_01H...", "provider": "shopify", "status": "connected", "connected_at": "..." }
  ],
  "ai_conversations": [ ... ],
  "automation_events": [ ... ],
  "engine_runs": [ ... ],
  "metrics_daily": [ ... ],
  "escalation_tickets": [ ... ],
  "sentiment_logs": [ ... ],
  "churn_predictions": [ ... ],
  "response_templates": [ ... ],
  "knowledge_entries": [ ... ],
  "tables_en_erreur": [],
  "tables_tronquees": []
}

Format CSV

Content-Type: text/csv; charset=utf-8 Content-Disposition: attachment; filename="actero-export-2026-04-22T10-00-00.csv"

## client (1)
id,brand_name,plan,trial_ends_at,...
01HX...,Mon Shop,pro,,...

## settings (1)
client_id,brand_name,brand_tone,...
01HX...,Mon Shop,chaleureuse et simple,...

## ai_conversations (1247)
id,client_id,customer_email,...
...

Tables exportées

Section JSON	Table source	Contenu
`client`	`clients`	Métadonnées tenant : nom, plan, dates
`settings`	`client_settings`	Configuration : ton, marque, réglages de la bulle et de l’agent (sans clés ni mots de passe)
`integrations`	`client_integrations`	Connexions Shopify, Gorgias, etc. (sans tokens OAuth)
`ai_conversations`	`ai_conversations`	Historique conversations avec l’agent IA
`automation_events`	`automation_events`	Événements bruts entrants (legacy v1)
`engine_runs`	`engine_runs_v2`	Runs de l’engine v2 : classification, confiance, action plan, durée
`metrics_daily`	`metrics_daily`	Aggregats journaliers : volumes, latences, sentiment moyen
`escalation_tickets`	`escalation_tickets`	Tickets escaladés en validation humaine
`sentiment_logs`	`sentiment_logs`	Scores de sentiment par conversation
`churn_predictions`	`churn_predictions`	Prédictions churn customer
`response_templates`	`client_response_templates`	Modèles de réponse du tenant
`knowledge_entries`	`client_knowledge_base`	Articles de la base de connaissance

Les secrets sont volontairement exclus de l’export : jetons OAuth (Shopify, Gorgias…), mots de passe, clés d’API et colonnes chiffrées. Ils sont stockés chiffrés et liés à l’instance Actero ; ils ne sont pas portables. Pour migrer, reconnecte tes intégrations chez le nouveau prestataire.Les membres de l’équipe (client_users) et les règles de la page Restrictions (client_guardrails) ne font pas partie de l’export.

Response — autres cas

`401 Unauthorized`

{ "error": "Non autorisé" }

`400 Bad Request`

{ "error": "Précise la boutique à exporter (client_id)." }

Ton compte a plusieurs boutiques et la requête n’en désigne aucune.

`403 Forbidden`

{ "error": "Seuls le propriétaire et les managers de la boutique peuvent exporter ses données." }

Autres messages de 403 : Aucune boutique associée à ce compte. (aucune boutique liée au compte) et Cette boutique ne t’appartient pas. (le client_id n’est pas l’une de tes boutiques).

`405 Method Not Allowed`

Cet endpoint accepte uniquement GET.

Erreurs partielles

Si une table individuelle ne peut pas être lue, elle apparaît avec un tableau vide [] et son nom est listé dans tables_en_erreur, plutôt que de faire échouer tout l’export. La réponse reste 200 OK. Vérifie tables_en_erreur avant d’archiver.

Exemples

Les exemples utilisent le jeton de session (ACTERO_SESSION_TOKEN) et l’identifiant de ta boutique (ACTERO_CLIENT_ID).

# JSON
curl "https://actero.fr/api/client/export-data?format=json&client_id=$ACTERO_CLIENT_ID" \
  -H "Authorization: Bearer $ACTERO_SESSION_TOKEN" \
  -o actero-export.json

# CSV
curl "https://actero.fr/api/client/export-data?format=csv&client_id=$ACTERO_CLIENT_ID" \
  -H "Authorization: Bearer $ACTERO_SESSION_TOKEN" \
  -o actero-export.csv

import { writeFile } from 'node:fs/promises'

const url = new URL('https://actero.fr/api/client/export-data')
url.searchParams.set('format', 'json')
url.searchParams.set('client_id', process.env.ACTERO_CLIENT_ID)

const res = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.ACTERO_SESSION_TOKEN}` },
})

if (!res.ok) {
  throw new Error(`Export failed: ${res.status} ${await res.text()}`)
}

const bundle = await res.json()
console.log(`Conversations : ${bundle.ai_conversations.length}`)
console.log(`Runs engine : ${bundle.engine_runs.length}`)
if (bundle.tables_en_erreur.length) console.warn('Tables non lues :', bundle.tables_en_erreur)
if (bundle.export_partiel) console.warn(bundle.export_partiel)

await writeFile('actero-export.json', JSON.stringify(bundle, null, 2))

import os, requests

res = requests.get(
    "https://actero.fr/api/client/export-data",
    params={"format": "json", "client_id": os.environ["ACTERO_CLIENT_ID"]},
    headers={"Authorization": f"Bearer {os.environ['ACTERO_SESSION_TOKEN']}"},
)
res.raise_for_status()
bundle = res.json()

print(f"Conversations : {len(bundle['ai_conversations'])}")
if bundle["tables_en_erreur"]:
    print("Tables non lues :", bundle["tables_en_erreur"])

with open("actero-export.json", "wb") as f:
    f.write(res.content)

Performance et taille

L’export est synchrone : le serveur lit chaque table par pages, puis renvoie le tout dans une seule réponse. Pour garder une réponse que la plateforme accepte de transmettre (environ 4 Mo), la lecture s’arrête à des bornes : 20 000 lignes par table, un budget de taille et un budget de temps de 45 secondes.

Un export qui atteint une borne reste en 200 OK, mais il est partiel : le champ tables_tronquees liste les tables concernées, et export_partiel explique comment recevoir le reste.
Un export trop volumineux pour être téléchargé d’un coup répond 413 : écris à contact@actero.fr, on te l’envoie.

Suppression vs export

L’export ne supprime rien. Pour exercer ton droit à l’effacement (RGPD article 17), envoie un email à contact@actero.fr depuis l’adresse du propriétaire de la boutique. Ton agent est coupé tout de suite ; tes données sont détruites après un délai de grâce de 14 jours, pendant lequel tu peux annuler la demande. Voir Export RGPD.

Rate limit

Cette route n’a pas de limite de débit propre. Inutile d’en faire beaucoup : l’export représente un instantané, pas un flux temps réel. Pour suivre les nouvelles données au fil de l’eau, utilise les webhooks sortants.

Référence

Endpoints

GET /client/export-data

Authentification

Query params

Headers

Response — `200 OK`

Format JSON

Format CSV

Tables exportées

Response — autres cas

`401 Unauthorized`

`400 Bad Request`

`403 Forbidden`

`405 Method Not Allowed`

Erreurs partielles

Exemples

Performance et taille

Suppression vs export

Rate limit

​Authentification

​Query params

​Headers

​Response — 200 OK

​Format JSON

​Format CSV

​Tables exportées

​Response — autres cas

​401 Unauthorized

​400 Bad Request

​403 Forbidden

​405 Method Not Allowed

​Erreurs partielles

​Exemples

​Performance et taille

​Suppression vs export

​Rate limit

Authentification

Query params

Headers

Response — `200 OK`

Format JSON

Format CSV

Tables exportées

Response — autres cas

`401 Unauthorized`

`400 Bad Request`

`403 Forbidden`

`405 Method Not Allowed`

Erreurs partielles

Exemples

Performance et taille

Suppression vs export

Rate limit