List provider resources

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

List provider resources

cURL

curl --request POST \
  --url https://api.monid.ai/v1/discover/resources \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "category": "virtual-machines",
  "provider": "smolmachine"
}
'

200

{
  "items": [
    {
      "provider": "smolmachine",
      "providerDisplayName": "Smol Machines",
      "resource": "SmolmachineMachine",
      "resourceType": "machine",
      "displayName": "Virtual machine",
      "displayDescription": "<string>",
      "summary": "<string>",
      "pricing": {
        "rent": {
          "type": "BY_PERIOD",
          "amount": {
            "value": 123,
            "currency": "USD"
          },
          "period": {
            "unit": "MINUTE",
            "count": 123
          }
        },
        "rateCard": [
          {
            "label": "cpu",
            "ratePerUnit": 0.05,
            "per": "vCPU·hour"
          }
        ],
        "firstPeriodChargedAtCreation": true
      },
      "endpoints": [
        {
          "endpoint": "/machines",
          "displayName": "Create machine",
          "price": {
            "type": "<string>",
            "amount": {
              "value": 123,
              "currency": "USD"
            },
            "flatFee": {
              "value": 123,
              "currency": "USD"
            },
            "period": {
              "unit": "MINUTE",
              "count": 123
            },
            "per": {
              "unit": "MINUTE",
              "count": 123
            },
            "unit": "token",
            "default": {
              "type": "PER_CALL",
              "amount": {
                "value": 123,
                "currency": "USD"
              }
            },
            "selectors": [
              {
                "label": "<string>",
                "key": "<string>",
                "in": "body",
                "offset": 1
              }
            ],
            "variants": [
              {
                "when": {},
                "price": {
                  "type": "PER_CALL",
                  "amount": {
                    "value": 123,
                    "currency": "USD"
                  }
                },
                "label": "<string>"
              }
            ],
            "tiers": [
              {
                "label": "<string>",
                "price": {
                  "type": "PER_CALL",
                  "amount": {
                    "value": 123,
                    "currency": "USD"
                  }
                },
                "when": {},
                "selector": {
                  "label": "<string>",
                  "key": "<string>",
                  "in": "body",
                  "offset": 1
                }
              }
            ]
          },
          "effects": [
            "create"
          ]
        }
      ],
      "categories": [
        "<string>"
      ],
      "providerUrl": "<string>",
      "providerDocsUrl": "<string>"
    }
  ]
}

Authorizations

Authorization · string · header · required

Monid API key (Authorization: Bearer mk_...) or Clerk-issued JWT. Each operation lists the ONE scope an API key needs. {resource}:* grants every action on that resource; * grants everything; Clerk sessions hold *. Operations with an empty list need no scope. Scope catalog: GET /v1/api-keys/scopes.

Headers

X-Monid-Agent-Model · string

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

Maximum string length: 256

X-Monid-Agent-Harness · string

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).

Maximum string length: 256

X-Monid-Agent-Session-Id · string

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).

Maximum string length: 256

Body

application/json

category · string

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

Maximum string length: 60

Pattern: ^[a-z0-9]+(?:-[a-z0-9]+)*$

Example:

"virtual-machines"

provider · string

Exact provider slug.

Required string length: 1 - 200

Example:

"smolmachine"

Response

200

application/json

Matching resources

items · object[] · required

Show child attributes