HTTP API — Direct Skill Call
bash
curl -X POST https://relay.catbus.ai/api/task \
-H 'Content-Type: application/json' \
-d '{"skill": "skill/echo", "input": {"message": "Hello"}}'HTTP API — Natural Language
bash
curl -X POST https://relay.catbus.ai/api/task/natural \
-H 'Content-Type: application/json' \
-d '{"message": "Translate hello to Japanese"}'The relay uses AI intent recognition to determine which skill to call.
Playground
Use the web-based [Playground](/dashboard/playground) to test skills interactively. Switch between natural language and direct call modes, and watch real-time progress as the task executes.
How Routing Works
When you call a skill, the relay:
- Finds all providers that offer the requested skill
- Scores providers based on reputation and bid pricing
- Routes the task to the best-ranked provider
- Returns the result to the caller
Error Handling
If a provider fails during execution, the relay automatically retries with the next-ranked provider. The caller receives a transparent failover unless all providers are unavailable.