Discover

List provider resources

Changed on

The resources providers offer, with display copy, prices (recurring rent and metered usage rates) and the endpoints that operate on them. Filter by category and/or provider.

post/v1/discover/resources

Request

  • Base URL: https://api.monid.ai
  • URL: https://api.monid.ai/v1/discover/resources
  • Auth: HTTP bearer

Headers

X-Monid-Agent-Modelstring

Model driving the calling agent. Optional; a value that is empty, longer than 256 characters or not printable ASCII is ignored (never an error).

X-Monid-Agent-Harnessstring

Agent harness or client making the call (e.g. a coding agent, an agent framework). Optional; a value that is empty, longer than 256 characters or not printable ASCII is ignored (never an error).

X-Monid-Agent-Session-Idstring

Caller-side session identifier, so the calls of one agent session (discover → inspect → run → polling) can be correlated. Optional; a value that is empty, longer than 256 characters or not printable ASCII is ignored (never an error).

Request body

categorystring

Category node id to filter by (top group, leaf category, or provider node id).

providerstring

Exact provider slug.

Example request

{
  "category": "virtual-machines",
  "provider": "smolmachine"
}

Response

Matching resources

Example response

{
  "items": [
    {
      "provider": "smolmachine",
      "providerDisplayName": "Smol Machines",
      "resource": "SmolmachineMachine",
      "resourceType": "machine",
      "displayName": "Virtual machine",
      "pricing": {
        "rateCard": [
          {
            "label": "cpu",
            "ratePerUnit": 0.05,
            "per": "vCPU·hour"
          }
        ]
      },
      "endpoints": [
        {
          "endpoint": "/machines",
          "displayName": "Create machine",
          "effects": [
            "create"
          ]
        }
      ]
    }
  ]
}

Changes

  • 47b1a281e325Revision changes
    • warning

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

    • warning

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

    • warning

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

    • warning

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

  • 631143e91790Revision changes
    • info

      added the new optional header request parameter X-Monid-Agent-Harness

    • info

      added the new optional header request parameter X-Monid-Agent-Model

    • info

      added the new optional header request parameter X-Monid-Agent-Session-Id

    • info

      removed the PROMO_REDEEM_DISABLED enum value from the response property for the response status

    • info

      removed the PROMO_REDEEM_DISABLED enum value from the response property for the response status

    • info

      removed the PROMO_REDEEM_DISABLED enum value from the response property for the response status

    • info

      removed the PROMO_REDEEM_DISABLED enum value from the response property for the response status

    • info

      removed the PROMO_REDEEM_DISABLED enum value from the response property for the response status