Skip to content

docs: Add executor readiness gating to /v1/ready endpoint - #1733

Merged
lukekim merged 1 commit into
trunkfrom
docs/ready-executor-gating
May 18, 2026
Merged

lukekim merged 1 commit into
trunkfrom
docs/ready-executor-gating

Conversation

@claudespice

Copy link
Copy Markdown
Contributor

Summary

  • Add min_ready_executors, min_ready_executors_percent, and verbose query parameters to the /v1/ready endpoint in the OpenAPI spec and generated API docs
  • Document the 400 response code for invalid parameters or executor gates requested outside scheduler role
  • Add Kubernetes readiness probe example with executor gating

Source PRs

Changes

  • website/public/openapi.json — Added query parameters and 400 response to /v1/ready endpoint
  • website/docs/api/HTTP/ready.api.mdx — Regenerated from updated spec with executor gating description and examples
  • website/docs/api/HTTP/ready.*.json — New parameter/schema/status JSON files for the ready endpoint

Test plan

  • cd website && npm run build passes locally (Docusaurus throws on broken links and undefined frontmatter tags)
  • Links are valid
  • Version references are correct

Update OpenAPI spec and API docs for the new /v1/ready query parameters
that gate readiness on executor availability in distributed (scheduler) mode:
min_ready_executors, min_ready_executors_percent, and verbose.
@claudespice claudespice self-assigned this May 18, 2026
@github-actions

github-actions Bot commented May 18, 2026 •

Copy link
Copy Markdown
Contributor

✅ Pull with Spice Passed

Passing checks:

  • ✅ Title meets minimum length requirement (10 characters)
  • ✅ Has at least one of the required labels: area/blog, area/docs, area/cookbook, dependencies
  • ✅ No banned labels detected
  • ✅ Has at least one assignee: claudespice

@github-actions

Copy link
Copy Markdown
Contributor

🚀 deployed to https://ca3ec5b0.spiceai-org-website.pages.dev

@lukekim
lukekim merged commit d2bcc16 into trunk May 18, 2026
6 of 9 checks passed
@lukekim
lukekim deleted the docs/ready-executor-gating branch May 18, 2026 18:53

This branch was successfully deployed

1 active deployment
preview — 67a50a69 Deployed May 18, 2026 by github-actions[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants