API Referentie

REST API voor Conv-Flow. Consoleroutes vereisen sessiecookie of API-sleutel (Bearer cf_xxx).

Authenticatie

Registreer en log in voor een sessiecookie. Voor programmatische toegang, gebruik API-sleutels uit Instellingen.

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"

API-sleutels

Maak sleutels aan in Instellingen. Gebruik in verzoeken:

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"

Conversaties (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"

Widget API

Eindgebruiker-chat. Authenticatie met X-Workflow-Token (publicatietoken).

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"

Inkomende webhook

Workflows triggeren vanuit Zapier, Make of elke HTTP-client.

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 (AI-agents)

MCP-endpoint voor Cursor, Claude, Windsurf, VS Code. Gebruik API-sleutel in Authorization-header. Zie Gebruikershandleiding → MCP voor setup.

POST/api/mcp

Headers

Authorization: Bearer cf_xxx

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

Tools: convflow_list_workflows, convflow_create_workflow, convflow_get_embed_snippet, etc.

Foutformaat

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