api.warmhub.ai

Showing 25 of 44 from the live probe.

• List Organizations

  List organizations visible to the current caller.

• Get Organization

  Get organization metadata by name.

• List Repositories

  List repos in an organization.

• Get Repository

  Get repo metadata by org and repo name.

• Describe Repository

  Describe a repo: metadata, schema (with per-shape queryHints), counts, and write operation contract.

• Create Repository

  Create a repo in an organization.

• Install Component

  Install a registered component (<org>/<name>) into a target repo: applies its manifest (shapes, credential sets, subscriptions, seeds) and runs the optional setup handshake. Returns the install state plus any setup-deferred resources.

• Uninstall Component

  Uninstall a registered component (<org>/<name>) from a repo: pauses its subscriptions, revokes its tokens, dispatches the optional uninstall callback, and marks the install record uninstalled. Non-destructive — manifest shapes and seeded data are left intact; reinstall revives the install. CLI: wh component teardown.

• List Shapes

  List shapes in a repo. Each item includes queryHints with suggested MCP query patterns for that shape. See: docs.warmhub.ai/data-modeling/shapes

• Get Shape

  Get a shape by name. Response includes queryHints with suggested MCP query patterns for that shape. See: docs.warmhub.ai/data-modeling/shapes

• Get Repository Content

  Fetch repo content by kind: readme, agents, or llms-txt (synthesized sitemap).

• Set Repository Content

  Set repo content by kind (commits a revise op). Note: --kind llms-txt is read-only and will error.

• Scaffold Shape Template

  Scaffold write-ops JSON for one or more shapes. Returns a ready-to-edit operations array suitable for warmhub_commit_submit. Pass shapeName(s) as a comma-separated list. See: docs.warmhub.ai/writes/operations#generating-templates

• List Organization Members

  List members of an organization.

• Run Diagnostics

  Run WarmHub connectivity and capability diagnostics (mirrors `wh doctor`). Returns server capabilities and a health probe.

• List Notifications

  List repo-scoped action notifications for the authenticated user (mirrors `wh notifications`).

• Create Collection

  Create an Arc, Bond, Set, or List collection thing. This is UX sugar over the existing commit primitives; named collections can be revised through collection tools.

• List Collection Members

  List collection members with stable indexes and pagination. orgName and repoName may be omitted when wref is a self-routing durable ID.

• Check Collection Membership

  Check whether one or more wrefs are members of a collection. orgName and repoName may be omitted when wref is a self-routing durable ID.

• Diff Collections

  Compare two collections by membership or order. orgName and repoName may be omitted when both collection refs are self-routing durable IDs.

• Revise Collection

  Revise a named collection by replacement, set delta, or selector-backed replacement.

• Get Collection Stats

  Summarize collection type and member counts. orgName and repoName may be omitted when wref is a self-routing durable ID.

• List Things at HEAD

  List or count items at HEAD with optional filters. For an incremental scan, send sinceRepoSeq (-1 to seed), follow every nextCursor with the same lower bound and limit, and save repoSeq only from the exhausted final page or exact count. Requires full-repository read authority and an authoritative PostgreSQL plan. For fuzzy lookups use warmhub_thing_search. CLI: wh thing list. See: docs.warmhub.ai/queries/head

• Get Things

  Fetch one or more things by wref in one call — pass all needed wrefs together rather than calling repeatedly. A wref that does not exist or is not visible to you is listed in "missing", not returned as an error. Pass includeRetracted: true to retrieve retracted versions. Pass dataMode:"full" to force large collection bodies. orgName and repoName may be omitted when every wref is a durable ID or canonical (wh:org/repo/...). See: docs.warmhub.ai/queries/filtering#get-by-wref

• Traverse Thing Graph

  Get one thing and its embedded assertion/about/wref graph to a bounded depth. orgName and repoName may be omitted when wref is a durable ID. See: docs.warmhub.ai/data-modeling/things