dograh/docs
Amaan Javed 9471041b8b
fix(api): validate pagination bounds on run-list endpoints (#553) (#554)
* fix(api): validate pagination bounds on run-list endpoints (#553)

GET /workflow/{id}/runs and GET /campaign/{id}/runs declared bare
`page: int = 1` / `limit: int = 50` params, then computed
`total_pages = (total_count + limit - 1) // limit`. A `?limit=0` raised an
unhandled ZeroDivisionError (HTTP 500), and negative limit/page produced a
negative offset and nonsensical pagination.

Add `Query(ge=1, le=100)` / `Query(1, ge=1)` bounds to both endpoints,
matching the sibling list endpoints (/usage/runs and the superuser runs
endpoint) that already validate these. Out-of-range values now return 422.

Adds a regression test covering limit=0/-5/101 and page=0 on both endpoints.

Fixes #553

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

* chore(docs): regenerate openapi.json for run-list pagination bounds (#553)

The added Query(ge/le) bounds on the workflow-run and campaign-run list
endpoints changed the OpenAPI schema; regenerate the committed spec via
`python -m scripts.dump_docs_openapi` so the drift-check passes. Only the
limit/page parameter schemas for those two endpoints change.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
Co-authored-by: Abhishek Kumar <abhishek@a6k.me>
2026-07-18 16:29:28 +05:30
..
api-reference fix(api): validate pagination bounds on run-list endpoints (#553) (#554) 2026-07-18 16:29:28 +05:30
configurations feat: add ElevenLabs realtime STT provider support (#512) (#522) 2026-07-13 14:47:07 +05:30
contribution chore: simplify dev setup docs (#520) 2026-07-10 16:09:37 +05:30
core-concepts docs: add missing cross-links for machine and human readability (#492) 2026-07-02 21:10:32 +05:30
deployment docs: fix dead entry points, add first-agent tutorial, explain unexplained features (#489) 2026-07-02 12:47:48 +05:30
developer feat(auth): gate OSS signup behind ENABLE_SIGNUP flag (#514) 2026-07-13 14:08:25 +05:30
getting-started docs: add video-embedded getting-started pages for API Trigger, Webhook, Telephony, Tools & KB (#535) 2026-07-15 18:37:52 +05:30
images docs: replace star history api with image 2026-07-15 14:20:41 +05:30
integrations Paygent integration new with revert pipecat/realtime changes (#539) 2026-07-15 13:09:05 +05:30
logo chore: Update README and add Mintlify docs 2025-10-04 15:05:07 +05:30
sdks feat: refactor node spec and add mcp tools (#244) 2026-04-21 07:56:16 +05:30
voice-agent docs: resolve call transfer destination dynamically 2026-07-10 21:59:17 +05:30
AGENTS.md chore: refactor AGENTS.md 2026-05-20 15:56:52 +05:30
CLAUDE.md chore: refactor AGENTS.md 2026-05-20 15:56:52 +05:30
custom.css style(docs): add custom green scrollbar (#434) 2026-06-20 15:10:08 +05:30
docs.json docs: add video-embedded getting-started pages for API Trigger, Webhook, Telephony, Tools & KB (#535) 2026-07-15 18:37:52 +05:30
favicon.ico chore: Update README and add Mintlify docs 2025-10-04 15:05:07 +05:30
README.md chore: Update README and add Mintlify docs 2025-10-04 15:05:07 +05:30

Dograh AI Documentation

Local Setup

  1. Install mintlify npm i -g mint
  2. Clone the repository
  3. cd dograh/docs and run mint dev