Docs · Guides
Publish and list services
A service is an HTTP API that you run and other HyperC members or their agents can call. This guide covers the path from your first Builder test to managing who can use the published service.
Where a market card describes a business opportunity, a service runs a specific task. For example, you can share a read-only inventory feed with a group so its agents can look up stock. HyperC sends authorized calls to the service and meters any charges in credits.
Build and run the service in Business Builder. Publish it to register its service ID with HyperC, then list it for each audience you want to reach. The Market Store’s My Services page shows your published services, listing decisions, services you can use, and your spending on calls.
Create, test and publish a service
- Sign in to your own hosted Business Builder workspace and open Create & Earn → Services. Verify your HyperC email address before publishing. A service that charges credits requires an eligible paid plan. Open Business Builder
- Under Create a service, enter a local Name, select a starting template, describe what the service should do, and choose Create with the builder. For a ready-made starting point, use Install here on a template, or select Set up with your agent for the setup instructions.
- In Builder’s My services, start the service if needed and use Test to check its health endpoint and a representative request. Use Logs if the test fails. Review what callers can do, the docs and any prices. If the service uses credentials, add them in Passwords & Keys and approve the specific bindings shown on the service card.
- Choose Publish. Check the price and choose a unique Service id of 3–48 lowercase letters, digits or dashes, starting with a letter. Select the workspace that will run it if prompted. Choose Publish again in the dialog and complete the confirmation on HyperC. If the tab was blocked, follow Confirm on HyperC in Builder.
- Check that the service now appears under My services in the Market Store. It is registered under that ID. Request a listing to give other accounts access. Open My Services
List a service in a group
- Join the group first and use the account that owns the service.
- In My Services, find the published service. In Where to list it, select the group and choose List it. Repeat for any other groups you want to reach.
- Check the status on the service card. A request from a group owner or admin who can publish there can be approved immediately. Other requests stay pending until a group owner or admin approves or declines in Group services on the group page or in their Hub inbox.
- Once approved, eligible group members can find it under Group services and Available to you. Both you and the caller must remain active members for access through that group. Open Groups
List a service in the public catalog
- Review your service’s name, description, docs, and OpenAPI definition before making them public.
- In My Services, select HyperC’s public catalog under Where to list it and choose List it.
- Check the listing status after HyperC reviews it. Once approved, anyone can discover the listing. Calling the service requires a HyperC identity and any verification the service requires.
You can also request either listing from Builder. Choose List in a group / public, select the group or The public catalog (HyperC reviews it), then choose List it and confirm on HyperC when prompted.
Withdraw, pause or retire a service
- Withdraw a listing. In My Services, choose Withdraw next to the approved or pending group or public listing. Withdraw every applicable listing if you want to remove access through all audiences. You can request a new listing later.
- Pause new calls. Choose Pause on the service to stop new calls across all its listings. The entry can remain visible with a paused status. Choose Resume to accept calls again.
- Retire a service ID. Choose Retire to permanently stop new calls to that ID and withdraw its listings. For services with metered events that occur after a call, eligible charges from earlier calls can still settle within their allowed window.
Builder’s Stop shuts down the running process. Use Withdraw in My Services when you want to remove a listing.
Availability, pricing and data
- Availability. A Builder-hosted service needs its hosting workspace and process to be available. Services on invite or trial workspaces can sleep with the workspace. If an approved service fails, check its status, test it in Builder, and read its logs.
- Updates and review. Changes to the published description, docs, OpenAPI or data disclosures can send a public listing back to review. Group listings can show changed since approval. Changing where the service runs can require new approval for every listing.
- Pricing. Charges can include a per-call price, metered usage, and charges tied to later events. HyperC deducts a fee from paid usage. Prices are fixed for a service ID. Change price creates a successor ID, and a price or cap increase can send carried-over listings back for review. Callers should check the new ID and maximum charge before switching.
- Caller limits. Check a service card’s maximum charge and what it receives. Your spend on group services shows recent charges and lets you set a daily limit or dispute a charge. If a service has later charges, its Docs page lets you refuse them. Calls from a shared Builder workspace use the workspace owner’s identity and credits.
- Privacy. Service owners receive caller account IDs and usernames, and some services receive verified email addresses. Review the disclosures on the service card. Keep passwords, API keys, and private workspace links out of your service docs and requests.