Skip to main content
Conductor exposes a lightweight HTTP surface for external automation.

Trigger a task over HTTP

curl -X POST http://localhost:4747/api/webhook/task \
  -H "Content-Type: application/json" \
  -d '{"task":"fix the auth bug","project":"my-app","agent":"claude-code"}'

Endpoint summary

  • POST /api/webhook/task
  • POST /api/webhook/github
  • GET /api/webhook/status
  • GET /api/webhook/health

Standalone webhook server

If you only need the webhook listener:
co webhook --port 4748

Security

Use WEBHOOK_SECRET for GitHub HMAC verification and keep the listener behind a trusted network path when possible.
Last modified on March 6, 2026