All Systems OperationalAPI v1.0Need help? Contact engineering
Developer Platform

Build on the PulseFlow API.

Everything you need to integrate workflows, agents, events and observability into your own products.

Make your first API request.

PulseFlow exposes a REST API for creating events, executing workflows, inspecting runs and managing resources programmatically.

Terminal
curl https://api.pulseflow.ai/v1/health \
  -H "Authorization: Bearer pf_live_your_key"
API requests use HTTPS and return JSON responses. Keep secret keys server-side and never expose them in browser code.

Secure every request.

Authenticate requests using a PulseFlow secret key in the Authorization header.

HTTP
Authorization: Bearer pf_live_****************
Never expose secret keys client-side.

Use server-side environment variables or your organization's secret manager.

Events API

Create an event and route it into a configured workflow.

POST /v1/events Create an execution event
Request
curl -X POST https://api.pulseflow.ai/v1/events \
  -H "Authorization: Bearer pf_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow_id": "wf_customer_intent",
    "event": "customer.message",
    "payload": {
      "customer_id": "cus_82391",
      "message": "I need help with my account"
    }
  }'

Response

JSON
{
  "id": "exec_01J9X2K9",
  "status": "queued",
  "workflow_id": "wf_customer_intent",
  "created_at": "2026-09-09T08:42:11Z"
}

Listen for workflow events.

Webhooks allow your infrastructure to receive execution state changes from PulseFlow.

workflow.completedSent when an execution finishes successfully.
workflow.failedSent when execution terminates unsuccessfully.

Predictable error handling.

400Invalid request parameters
401Authentication failed
403Insufficient permissions
404Resource not found
429Rate limit exceeded
500Internal server error

Use your preferred language.

JavaScriptNode.js SDK
PythonPython SDK
GoGo SDK
JavaJava SDK

Built for high-volume workloads.

Standard API access uses burst-aware rate limiting. Enterprise deployments can be configured around workload-specific requirements.