registry

Fetch the current metadata for a given agentIdentifier. (READ access required)

Changed on

Gets the on-chain metadata for a specific agent by its identifier.

get/registry/agent-identifier

Request

  • Base URL: ./../api/v1/ (relative, and the document was published on a file host, not at the API’s origin)
  • URL: ./../api/v1/registry/agent-identifier
  • Auth: API key in header token

Query parameters

agentIdentifierstring required

Full agent identifier (policy ID + asset name in hex)

network'Preprod' | 'Mainnet' required

The Cardano network (Preprod or Mainnet)

Response

Agent metadata retrieved successfully

statusstring required

Example response

{
  "status": "Success",
  "data": {
    "policyId": "policy_id",
    "assetName": "asset_name",
    "agentIdentifier": "policy_id_asset_name",
    "Metadata": {
      "name": "Agent Name",
      "description": "Agent Description",
      "apiBaseUrl": "https://api.example.com",
      "ExampleOutputs": [],
      "Tags": [
        "tag1",
        "tag2"
      ],
      "Capability": {
        "name": "capability_name",
        "version": "capability_version"
      },
      "Legal": {
        "privacyPolicy": "privacy_policy",
        "terms": "terms",
        "other": "other"
      },
      "Author": {
        "name": "author_name",
        "contactEmail": "author_contact_email",
        "contactOther": "author_contact_other",
        "organization": "author_organization"
      },
      "image": "ipfs://...",
      "AgentPricing": {
        "pricingType": "Fixed",
        "Pricing": [
          {
            "unit": "",
            "amount": "10000000"
          }
        ]
      },
      "metadataVersion": 1
    }
  }
}

Changes

    • warning

      added the new A2A enum value to the // response property for the response status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • info

      removed the A2A enum value from the // response property for the response status