Conv-Flow logoConv-Flow

Référence API

API REST pour Conv-Flow. Les routes console exigent un cookie de session ou une clé API (Bearer cf_xxx).

Authentification

Inscrivez-vous et connectez-vous pour obtenir un cookie de session. Pour un accès programmatique, utilisez les clés API dans Paramètres.

POST/api/v1/console/auth/signup

Body

{
  "email": "[email protected]",
  "password": "password123"
}

curl -X POST "https://www.conv-flow.com/api/v1/console/auth/signup" -H "Content-Type: application/json" -d '{"email":"[email protected]","password":"password123"}'

POST/api/v1/console/auth/login

Body

{
  "email": "[email protected]",
  "password": "password123"
}

curl -X POST "https://www.conv-flow.com/api/v1/console/auth/login" -H "Content-Type: application/json" -d '{"email":"[email protected]","password":"password123"}'

GET/api/v1/console/auth/me

curl -X GET "https://www.conv-flow.com/api/v1/console/auth/me"

Clés API

Créez des clés dans Paramètres. Utilisez-les dans les requêtes :

Authorization: Bearer cf_your_api_key
# or
X-API-Key: cf_your_api_key

Workflows (console)

GET/api/v1/console/workflows

curl -X GET "https://www.conv-flow.com/api/v1/console/workflows"

POST/api/v1/console/workflows

Body

{
  "name": "My workflow",
  "description": "Optional"
}

curl -X POST "https://www.conv-flow.com/api/v1/console/workflows" -H "Content-Type: application/json" -d '{"name":"My workflow","description":"Optional"}'

GET/api/v1/console/workflows/:workflowId

curl -X GET "https://www.conv-flow.com/api/v1/console/workflows/:workflowId"

PATCH/api/v1/console/workflows/:workflowId

Body

{
  "name": "Updated name",
  "draftGraphJson": {
    "nodes": [],
    "edges": []
  }
}

curl -X PATCH "https://www.conv-flow.com/api/v1/console/workflows/:workflowId" -H "Content-Type: application/json" -d '{"name":"Updated name","draftGraphJson":{"nodes":[],"edges":[]}}'

POST/api/v1/console/workflows/:workflowId/publish

curl -X POST "https://www.conv-flow.com/api/v1/console/workflows/:workflowId/publish"

POST/api/v1/console/workflows/:workflowId/duplicate

curl -X POST "https://www.conv-flow.com/api/v1/console/workflows/:workflowId/duplicate"

Conversations (console)

GET/api/v1/console/workflows/:workflowId/conversations?limit=20&offset=0

curl -X GET "https://www.conv-flow.com/api/v1/console/workflows/:workflowId/conversations?limit=20&offset=0"

GET/api/v1/console/conversations/:conversationId/messages

curl -X GET "https://www.conv-flow.com/api/v1/console/conversations/:conversationId/messages"

DELETE/api/v1/console/conversations/:conversationId

curl -X DELETE "https://www.conv-flow.com/api/v1/console/conversations/:conversationId"

Analytics

GET/api/v1/console/workflows/:workflowId/analytics?from=2026-02-01&to=2026-02-14

curl -X GET "https://www.conv-flow.com/api/v1/console/workflows/:workflowId/analytics?from=2026-02-01&to=2026-02-14"

API Widget

Chat utilisateur final. Authentification via X-Workflow-Token (token de publication).

POST/api/v1/widget/:workflowId/conversations

Headers

X-Workflow-Token: ptk_live_xxx

Body

{
  "externalUserId": "optional",
  "metadata": {
    "locale": "fr-FR"
  }
}

curl -X POST "https://www.conv-flow.com/api/v1/widget/:workflowId/conversations" -H "X-Workflow-Token: ptk_live_xxx" -H "Content-Type: application/json" -d '{"externalUserId":"optional","metadata":{"locale":"fr-FR"}}'

POST/api/v1/widget/:workflowId/conversations/:conversationId/messages

Headers

X-Workflow-Token: ptk_live_xxx

Body

{
  "content": "Hello"
}

curl -X POST "https://www.conv-flow.com/api/v1/widget/:workflowId/conversations/:conversationId/messages" -H "X-Workflow-Token: ptk_live_xxx" -H "Content-Type: application/json" -d '{"content":"Hello"}'

GET/api/v1/widget/:workflowId/conversations/:conversationId/messages

Headers

X-Workflow-Token: ptk_live_xxx

curl -X GET "https://www.conv-flow.com/api/v1/widget/:workflowId/conversations/:conversationId/messages" -H "X-Workflow-Token: ptk_live_xxx"

Webhook entrant

Déclenchez des workflows depuis Zapier, Make ou tout client HTTP.

POST/api/v1/widget/:workflowId/webhook

Headers

x-publish-token: ptk_live_xxx

Body

{
  "content": "Hello from Zapier"
}

curl -X POST "https://www.conv-flow.com/api/v1/widget/:workflowId/webhook" -H "x-publish-token: ptk_live_xxx" -H "Content-Type: application/json" -d '{"content":"Hello from Zapier"}'

MCP (agents IA)

Endpoint MCP pour Cursor, Claude, Windsurf, VS Code. Utilisez la clé API dans l'en-tête Authorization. Voir Guide → MCP pour la configuration.

POST/api/mcp

Headers

Authorization: Bearer cf_xxx

curl -X POST "https://www.conv-flow.com/api/mcp" -H "Authorization: Bearer cf_xxx"

Outils : convflow_list_workflows, convflow_create_workflow, convflow_get_embed_snippet, etc.

Format des erreurs

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Not authenticated",
    "details": {}
  }
}