Search for data endpoints (deprecated)

Semantic search over the endpoint catalog: registry kNN retrieval, signal-based reranking, relevance floors, and per-result pricing. DEPRECATED in favor of POST /v1/discover/endpoints (same pipeline, card response shape, larger page cap); kept for existing CLI/MCP callers and removed in a future release.

POST /v1/discover

Search for data endpoints (deprecated)

cURL

curl --request POST \
  --url https://api.monid.ai/v1/discover \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "twitter posts",
  "limit": 5,
  "minScore": 0.2,
  "includeUnavailable": false,
  "supportsX402": true,
  "x402Network": "eip155:8453",
  "readonly": true,
  "effects": [
    "creates",
    "deletes"
  ]
}
'

200

{
  "results": [
    {
      "provider": "exa",
      "endpoint": "/search",
      "description": "<string>",
      "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
            }
          }
        ]
      },
      "score": 123,
      "tags": [
        "<string>"
      ],
      "providerName": "<string>",
      "promotion": {
        "campaignId": "<string>",
        "label": "<string>",
        "discountPercent": 123,
        "limits": {
          "perMinute": 123,
          "perHour": 123,
          "perDay": 123
        },
        "baseEndpoint": "<string>"
      },
      "metrics": {
        "status": "healthy",
        "runTimeMs": {
          "p50": 123,
          "p95": 123
        }
      },
      "hints": {}
    }
  ],
  "query": "<string>",
  "count": 123
}

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

query · string · required

Natural-language search query for data endpoints.

Required string length: 1 - 1000

Example:

"twitter posts"

limit · integer · default: 5

Requested result count. A config-driven server-side cap (api-config discover.maxResults) applies.

Example:

5

minScore · number

Per-call override for the post-rerank score floor. Results scoring below this are filtered out before truncation to limit. Falls back to the configured default when omitted.

Required range: 0 <= x <= 2

Example:

0.2

includeUnavailable · boolean · default: false

Endpoints currently in outage are hidden by default (the page is back-filled from the next ranked candidates). Set true to include them — marked metrics.status: "outage" and ranked last.

Example:

false

supportsX402 · boolean

Filter by static eligibility for x402 payment (POST /x402/v1/run): true keeps only payable endpoints, false only non-payable ones. Omit for all endpoints. Network availability and request/payment validation are checked at execution time.

x402Network · string

Narrow to endpoints payable via x402 on this customer-payment network (CAIP-2 id, e.g. eip155:8453). Implies supportsX402=true; an unknown/unconfigured id returns an empty page.

Required string length: 1 - 100

Example:

"eip155:8453"

readonly · boolean

Filter by whether running the endpoint can change your workspace resources (phone numbers, files, asset libraries): true keeps only endpoints that cannot create, modify or delete them, false only endpoints that can. Omit for all endpoints. This describes RESOURCE effects only — a readonly endpoint may still perform real-world actions and is still billed.

effects · enum<string>[]

Keep only endpoints whose run can have AT LEAST ONE of the named effects on your workspace resources (phone numbers, files, asset libraries): creates, updates, deletes. Omit for all endpoints. Takes precedence over readonly (readonly=true is the alias for "no write effects"). Resource effects only — an endpoint with no effect may still perform real-world actions and is still billed.

Minimum array length: 1

Available options: creates, updates, deletes

Example:

["creates", "deletes"]

Response

200

application/json

Ranked endpoint recommendations

results · object[] · required

Show child attributes

query · string · required

count · number · required