ValidFlow REST API reference

The ValidFlow REST API lets you automate board validation, trigger repository audits, retrieve confidence scores, and integrate data quality checks into your CI/CD pipelines and internal tools programmatically.

Authenticate with a Bearer token (JWT) obtained by calling POST /api/auth/login with your credentials. The API supports all core operations including connecting platforms, managing boards, creating and updating validation rules, triggering asynchronous validation jobs, and retrieving confidence scores with detailed issue-level results and dimension breakdowns.

Key endpoints include POST /api/validations/run/:boardId to run a validation job on any connected board, GET /api/validations/confidence/:boardId to retrieve the current Data Confidence Score with dimension breakdowns, GET /api/validations/results/:resultId for detailed item-level findings, and GET /api/boards to list all connected boards.

Rate limits are 100 requests per 15-minute window. Most responses use JSON. The OpenAPI specification at /api/docs/openapi documents the authentication and platform-connection endpoints; additional routes are documented in the interactive API reference.

Common use cases for the API include triggering validation runs after deployments in CI/CD pipelines, building internal dashboards that display confidence scores across all team boards, and integrating quality gates into release approval workflows.