registry

Discover Agent

Fetch and validate an agent manifest from a URL.

Tries: {url}/.well-known/agent.json first, then {url}/agent.json as fallback. Also pings the health endpoint if declared in the manifest.

Requires authentication — registry mutation/discovery is a logged-in-only action (SEC-AUTH per Phase-1 audit). Without auth, an unauth caller could cycle the discovery loop to consume server CPU + outbound bandwidth.

post/api/v1/registry/discover

Request

  • Base URL: https://api.badgeia.com
  • URL: https://api.badgeia.com/api/v1/registry/discover
  • Auth: none declared

Request body

urlstring required

Base URL of the agent (manifest fetched from {url}/.well-known/agent.json)

Example request

{
  "url": "https://agents.acme.ai/explorer-llama"
}

Response

Successful Response

health_okboolean
health_latency_msinteger nullable
source_urlstring required

Example response

{
  "manifest": {
    "name": "Explorer-Llama",
    "version": "1.2.0",
    "provider": {
      "name": "Acme AI Labs",
      "url": "https://acme-ai.dev"
    },
    "endpoint": {
      "base_url": "https://agents.acme.ai/explorer"
    },
    "capabilities": {
      "domains": [
        "code_generation",
        "tool_use"
      ],
      "max_context_tokens": 128000,
      "tools": [
        {
          "name": "web_search"
        }
      ],
      "skills": [
        "code_review",
        "debugging",
        "api_design"
      ],
      "languages": [
        "python",
        "typescript",
        "go"
      ]
    },
    "model": {
      "name": "llama-3.2-70b",
      "provider": "meta",
      "architecture": "react"
    },
    "meta": {
      "tags": [
        "react",
        "tool-use"
      ]
    },
    "ml_bom": {
      "models": [
        {
          "id": "gpt-4o-mini",
          "provider": "openai",
          "role": "primary"
        }
      ],
      "tools": [
        {
          "name": "web_search",
          "kind": "retrieval"
        }
      ],
      "routing_policy": "single-model"
    },
    "signatures": [
      {
        "alg": "EdDSA"
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.