Skip to content

docs(api): document host_id filtering with notin exclusion example in search offers - #926

Open
guthrie-vast wants to merge 1 commit into
mainfrom
docs/search-offers-host-exclusion
Open

docs(api): document host_id filtering with notin exclusion example in search offers#926
guthrie-vast wants to merge 1 commit into
mainfrom
docs/search-offers-host-exclusion

Conversation

@guthrie-vast

Copy link
Copy Markdown
Collaborator

What

  • Expands the host_id property description in search_offers.yaml with usage examples (eq for a single host, notin to exclude hosts), plus a notin schema example
  • Adds a host-exclusion example to the filter-operators section of the endpoint description

Why

host_id is filterable in offer search — including notin to exclude specific hosts — and works for any API key (verified against the live API), but the schema entry read only "Host user ID" with no hint it accepts filter operators. Users wanting to avoid particular hosts had no documented way to discover this.

Companion CLI help-text PR: vast-ai/vast-cli#494

🤖 Generated with Claude Code

… search offers

host_id is filterable in offer search (including notin to exclude specific
hosts) but the schema entry gave no usage guidance. Expand the property
description and add an exclusion example to the operator docs.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@mintlify

mintlify Bot commented Aug 14, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
vastai-80aa3a82 🟢 Ready View Preview Aug 14, 2026, 1:04 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants