Discover

Semantic search grouped into categories

Changed on

The shared discover pipeline's match set aggregated into category nodes with per-node match counts — the semantic twin of GET /public/v1/categories?q= (same response shape; counts are within the bounded semantic match set).

post/v1/discover/categories

Request

  • Base URL: https://api.monid.ai
  • URL: https://api.monid.ai/v1/discover/categories
  • 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

qstring required

Natural-language search query.

minScorenumber

Per-call override for the post-rerank score floor — same semantics as the legacy POST /v1/discover body field.

includeUnavailableboolean

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.

supportsX402boolean

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.

x402Networkstring

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.

readonlyboolean

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.

effectsstring[]

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.

Example request

{
  "q": "twitter posts",
  "minScore": 0.2,
  "x402Network": "eip155:8453",
  "effects": [
    "creates",
    "deletes"
  ]
}

Response

Category nodes with semantic match counts

totalEndpointCountinteger required

Exact number of catalog-visible endpoints (with q: matching the query) — drives the All rail count.

Example response

{
  "items": [
    {
      "noMarkup": "all"
    }
  ]
}

Changes

  • 79c4c3aaa5ffRevision changes
    • info

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

    • info

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

    • info

      added the required property ////// to the response with the 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