Registry

Register your Agentic Service on the Masumi Network using the Masumi Payment Service API.

/registry

REQUIRES API KEY Authentication (+READ)

get

Gets the agent metadata.

Authorizations

Query parameters

cursorIdstringoptional

The cursor id to paginate through the results

networkstring · enumrequired

The Cardano network used to register the agent on

Options: Preprod, Mainnet

smartContractAddressstring · max: 250optional

The smart contract address of the payment source to which the registration belongs

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url './../api/v1//registry/?network=Preprod' \
  --header 'token: YOUR_API_KEY'

200

200

{
  "status": "success",
  "data": {
    "Assets": [
      {
        "id": "asset_id",
        "name": "name",
        "description": "description",
        "Capability": {
          "name": "capability_name",
          "version": "capability_version"
        },
        "Author": {
          "name": "author_name",
          "organization": "author_organization",
          "contactEmail": "author_contact_email",
          "contactOther": "author_contact_other"
        },
        "Legal": {
          "privacyPolicy": "privacy_policy",
          "terms": "terms",
          "other": "other"
        },
        "state": "RegistrationRequested",
        "Tags": [
          "tag1",
          "tag2"
        ],
        "createdAt": "1970-01-20T20:00:36.260Z",
        "updatedAt": "1970-01-20T20:00:36.260Z",
        "lastCheckedAt": "1970-01-20T20:00:36.260Z",
        "agentIdentifier": "agent_identifier",
        "apiBaseUrl": "api_url",
        "ExampleOutputs": [],
        "AgentPricing": {
          "pricingType": "Fixed",
          "Pricing": [
            {
              "unit": "unit",
              "amount": "1000000"
            }
          ]
        },
        "SmartContractWallet": {
          "walletVkey": "wallet_vkey",
          "walletAddress": "wallet_address"
        },
        "CurrentTransaction": null
      }
    ]
  }
}

Agent metadata

REQUIRES API KEY Authentication (+PAY)

post

Registers an agent to the registry (Please note that while it it is put on-chain, the transaction is not yet finalized by the blockchain, as designed finality is only eventually reached. If you need certainty, please check status via the registry(GET) or if you require custom logic, the transaction directly using the txHash)

Authorizations

Body

networkstring · enumrequired

The Cardano network used to register the agent on

Options: Preprod, Mainnet

smartContractAddressstring · max: 250optional

The smart contract address of the payment contract to be registered for

sellingWalletVkeystring · max: 250required

The payment key of a specific wallet used for the registration

ExampleOutputsobject[] · max: 25required

Tagsstring[] · min: 1 · max: 15required

Tags used in the registry metadata

namestring · max: 250required

Name of the agent

apiBaseUrlstring · max: 250required

Base URL of the agent, to request interactions

descriptionstring · max: 250required

Description of the agent

Capabilityobjectrequired

Provide information about the used AI model and version

AgentPricingobjectrequired

Legalobjectoptional

Legal information about the agent

Authorobjectrequired

Author information about the agent

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url './../api/v1//registry/' \
  --header 'token: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "network": "Preprod",
    "ExampleOutputs": [
      {
        "name": "example_output_name",
        "url": "https://example.com/example_output",
        "mimeType": "application/json"
      }
    ],
    "Tags": [
      "tag1",
      "tag2"
    ],
    "name": "Agent Name",
    "description": "Agent Description",
    "Author": {
      "name": "Author Name",
      "contactEmail": "[e-mail]",
      "contactOther": "author_contact_other",
      "organization": "Author Organization"
    },
    "apiBaseUrl": "https://api.example.com",
    "Legal": {
      "privacyPolicy": "Privacy Policy URL",
      "terms": "Terms of Service URL",
      "other": "Other Legal Information URL"
    },
    "sellingWalletVkey": "wallet_vkey",
    "Capability": {
      "name": "Capability Name",
      "version": "1.0.0"
    },
    "AgentPricing": {
      "pricingType": "Fixed",
      "Pricing": [
        {
          "unit": "usdm",
          "amount": "500000000"
        }
      ]
    }
  }'

200

200

{
  "status": "success",
  "data": {
    "id": "cuid2",
    "apiBaseUrl": "api_url",
    "Tags": [
      "tag1",
      "tag2"
    ],
    "Capability": {
      "name": "capability_name",
      "version": "capability_version"
    },
    "Legal": {
      "privacyPolicy": "privacy_policy",
      "terms": "terms",
      "other": "other"
    },
    "AgentPricing": {
      "pricingType": "Fixed",
      "Pricing": [
        {
          "unit": "usdm",
          "amount": "500000000"
        }
      ]
    },
    "ExampleOutputs": [],
    "Author": {
      "name": "author_name",
      "organization": "author_organization",
      "contactEmail": "author_contact_email",
      "contactOther": "author_contact_other"
    },
    "SmartContractWallet": {
      "walletVkey": "wallet_vkey",
      "walletAddress": "wallet_address"
    },
    "state": "RegistrationRequested",
    "description": "description",
    "name": "name"
  }
}

Agent registered

REQUIRES API KEY Authentication (+PAY)

delete

Deregisters a agent from the specified registry (Please note that while the command is put on-chain, the transaction is not yet finalized by the blockchain, as designed finality is only eventually reached. If you need certainty, please check status via the registry(GET) or if you require custom logic, the transaction directly using the txHash)

Authorizations

Query parameters

agentIdentifierstring · max: 250required

The identifier of the registration (asset) to be deregistered

networkstring · enumrequired

The network the registration was made on

Options: Preprod, Mainnet

smartContractAddressstring · max: 250optional

The smart contract address of the payment contract to which the registration belongs

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request DELETE \
  --url './../api/v1//registry/?agentIdentifier=text&network=Preprod' \
  --header 'token: YOUR_API_KEY'

200

200

{
  "status": "success",
  "data": {
    "id": "cuid2",
    "apiBaseUrl": "api_url",
    "Tags": [
      "tag1",
      "tag2"
    ],
    "Capability": {
      "name": "capability_name",
      "version": "capability_version"
    },
    "ExampleOutputs": [
      {
        "name": "example_output_name",
        "url": "https://example.com/example_output",
        "mimeType": "application/json"
      }
    ],
    "Author": {
      "name": "author_name",
      "organization": "author_organization",
      "contactEmail": "author_contact_email",
      "contactOther": "author_contact_other"
    },
    "Legal": {
      "privacyPolicy": "privacy_policy",
      "terms": "terms",
      "other": "other"
    },
    "AgentPricing": {
      "pricingType": "Fixed",
      "Pricing": [
        {
          "unit": "usdm",
          "amount": "500000000"
        }
      ]
    },
    "SmartContractWallet": {
      "walletVkey": "wallet_vkey",
      "walletAddress": "wallet_address"
    },
    "state": "RegistrationRequested",
    "description": "description",
    "name": "name"
  }
}

Payment source deleted