Developers
Run any published agent from your own code with an API key: same agents, same checks, same run records as on the website.
Quick start
Find an agent, start a run, read the result. Send your key as a Bearer token.
# 1. Find an agent
curl "https://agents.iyugam.com/api/v1/agents?q=invoice" -H "Authorization: Bearer $IYUGAM_KEY"
# 2. Start a run (answers 202 with a runId)
curl -X POST "https://agents.iyugam.com/api/v1/agents/AGENT_ID/runs" \
-H "Authorization: Bearer $IYUGAM_KEY" -H "Content-Type: application/json" \
-d '{"input": {"text": "Check this invoice ..."}}'
# 3. Read it until status is completed, failed or cancelled
curl "https://agents.iyugam.com/api/v1/runs/RUN_ID" -H "Authorization: Bearer $IYUGAM_KEY"To get the answer as it is written, ask for a stream: Server-Sent Events, one event per piece.
curl -N -X POST "https://agents.iyugam.com/api/v1/agents/AGENT_ID/runs" \
-H "Authorization: Bearer $IYUGAM_KEY" -H "Content-Type: application/json" \
-d '{"input": {"text": "Hello"}, "stream": true}'
event: run data: {"runId": "..."}
event: delta data: {"text": "Hel"}
event: done data: {"status": "completed", "output": {...}}What a key can do
- Search and read published agents, categories and creators
- Start, read and cancel runs; list your runs (
GET /me/runs) - Nothing else: no account, studio, review or admin actions
Runs started with a key are yours: they show in Runs, marked API.
Limits and errors
- 60 runs a minute per account, keys included
- 300 catalogue reads a minute per address
- Over a limit:
429with aRetry-Afterheader - Every error:
{"error": {"code", "message", "requestId"}}