API Reference
Use the Edge Delta API to manage pipelines, alerts, and configurations with an interactive Swagger interface.
less than a minute
To use the Edge Delta API, you need:
See Manage Pipelines with the API for a complete workflow covering how to retrieve, update, validate, and deploy pipeline configurations programmatically.
AI Team integration: AI Teammates can also manage pipelines through natural language using the Edge Delta MCP connector.
OpenAPI Specification
The complete API specification is available in OpenAPI 3.0 format:
Spec URL: https://api2.edgedelta.com/swagger/doc.json
Common API Errors
| Code | Scenario | Example Response |
|---|---|---|
| 400 | Malformed JSON | {"Error":"json: expected 'null' but found invalid token..."} |
| 400 | Invalid field names | {"Error":"failed to unmarshal config...field not found"} |
| 401 | Invalid API token | {"Error":"Invalid authentication token specified"} |
| 401 | Missing API token | {"Error":"Failed to validate OAuth authentication cookie"} |
| 404 | Invalid pipeline ID | Empty body |
| 404 | Deploy to nonexistent pipeline | {"Error":"Configuration not found..."} |
The /confs/validate endpoint returns HTTP 200 with {"valid": false, "reason": "..."} for invalid configurations rather than an error status code.