API Reference — Vectora Docs

Authentication

All API requests require a Bearer token in the Authorization header:

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.vectora.dev/v1/workflows

Generate API keys from Settings → API Keys. Keys are scoped to your workspace and can be revoked at any time.

Base URL

https://api.vectora.dev/v1

Workflows

List workflows

GET /workflows

Returns all workflows in your workspace with their current status and last execution time.

Create workflow

POST /workflows
Content-Type: application/json

{
  "name": "Deployment notification",
  "trigger": {
    "type": "webhook",
    "config": { "path": "/deployments" }
  },
  "actions": [
    {
      "type": "slack.message",
      "config": { "channel": "#releases", "template": "Deployed {{version}}" }
    }
  ]
}

Webhooks

Vectora can send webhook events when workflows execute, fail, or when metrics cross thresholds.

Configure webhook endpoints at Settings → Webhooks. Each endpoint receives a signed payload:

{
  "event": "workflow.completed",
  "timestamp": "2025-05-20T14:30:00Z",
  "data": {
    "workflow_id": "wf_abc123",
    "status": "success",
    "duration_ms": 1240
  }
}

Verify webhook signatures using the signing secret provided when you create the endpoint.

Rate limits

Starter: 100 requests/minute
Growth: 1,000 requests/minute
Enterprise: Custom limits

Rate limit headers are included in every response:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 998
X-RateLimit-Reset: 1620000000