Pontx HubAPI reference for humans & agents
DOCSPontx Hub
Public docsv1
On this pageUniversal CLI

CLI / @pontx/hub-cli

One CLI for the entire API catalog.

Install @pontx/hub-cli to search, inspect, and preview every curated API and call Endpoints enabled for online execution, with JSON output for automation.

01

Install and configure

The universal package is @pontx/hub-cli and its executable is pontx-hub.

Global install
pnpm add --global @pontx/hub-cli
pontx-hub --help
02

Command map

Discovery commands are resource-centered; request commands follow API product → controller → Endpoint name.

listList API products
search <query>Search APIs, Endpoints, and Schemas
show <resource-id>Inspect a stable resource
<api> preview …Build a redacted preview
<api> call …Call through the controlled Hub proxy
sdk <api>Inspect SDK package and status
skill listList universal and product Skills
skill installInstall the universal pontx-hub Skill
skill install <apiSlug>Install a product Skill
03

Search and inspect

Search results include stable resource IDs that later commands and scripts can use directly.

Natural language
pontx-hub search "返回 dueDate 的接口" --locale zh --json
pontx-hub show endpoint:dida365/get-task-by-id

Repeat --type with api, endpoint, or schema; use --limit and --offset for stable pagination.

04

Build a request

Pass Endpoint parameters as same-name options; use --body for JSON and -H for an additional declared header.

Command anatomy
pontx-hub <api-product> preview [controller] <endpoint-name> --parameter value

# Controller present
pontx-hub frankfurter preview 'Exchange Rates' getLatestRates --base USD

# No meaningful controller
pontx-hub frankfurter-v2 preview getRates --base USD
--projectId 123
Preferred: use the PontxSpec parameter name directly.
--body '<json>'
Pass a JSON request body.
-H 'Header: value'
Add a declared raw header; never expose secrets in arguments.
05

Scripts and automation

Use --json for programs, and preserve the exit code and error.code.

Machine-readable output
pontx-hub search "exchange rate" --type endpoint --json > results.json

# Keep credentials in the environment, never in CLI arguments.
export PROVIDER_ACCESS_TOKEN="<from-your-secret-manager>"
pontx-hub <api-product> preview <endpoint-name>