Skip to main content

Discovery & Query Endpoints

Agent Discovery​

List All Agents​

GET /agents.json

Returns all registered agents across all domains.

curl "$BASE_URL/agents.json" \
  -H "Accept: application/json"

When calling the testing environment through APIM, use the APIM-published runtime prefix when present, for example /ai/agents.json.

Response:

{
  "target": "all",
  "count": 15,
  "items": [
    {
      "id": "sdac_coordinator-release-agent",
      "name": "SDAC Coordinator Release",
      "description": "SDAC cost report analysis assistant"
    },
    {
      "id": "tap-caption-tagging-agent",
      "name": "TAP Tagging Suggestions Agent",
      "description": "Suggestions-only tag and caption generation"
    }
  ]
}

Get Agent Details​

GET /api/agents/{agentId}

Returns Mastra SDK metadata for a specific agent. APIM environments that publish the runtime under /ai expose the same route as /ai/api/agents/{agentId}.

Tool Discovery​

List All Tools​

GET /tools.json

Returns registered tools with metadata for UI discovery. Use the generated OpenAPI files for full request and response schemas.

curl "$BASE_URL/tools.json" \
  -H "Accept: application/json"

Use the id values from this response with the generic execution route POST /api/tools/{toolId}/execute, or use the domain route listed by /{domain}/routes.json.

Workflow Discovery​

List All Workflows​

GET /workflows.json

Returns all registered workflows.

Domain Discovery​

Each domain exposes a route inventory endpoint:

GET /\{domain\}/routes.json

Example:

curl "$BASE_URL/sdac/routes.json"

When APIM publishes runtime routes under /ai, the testing URL is /ai/{domain}/routes.json.

Response:

{
  "domain": "sdac",
  "toolCount": 41,
  "agentCount": 9,
  "workflowCount": 1,
  "tools": [
    "/sdac/tools/validate-source-codes",
    "/sdac/tools/validate-fringe",
    "/sdac/tools/detect-duplicates"
  ],
  "agents": [
    "/sdac/agents/coordinator-release/generate",
    "/sdac/agents/coordinator-release/stream"
  ],
  "workflows": [
    "/sdac/workflows/prompt-tuning"
  ]
}

Available domain prefixes: k12, tap, sdac, reasoning-engine