iYugam Agents

Developers

Run any published agent from your own code with an API key: same agents, same checks, same run records as on the website.

Loading

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: 429 with a Retry-After header
  • Every error: {"error": {"code", "message", "requestId"}}