Endpoints

Browse the endpoint catalog

Changed on

Cursor-paginated, cross-provider browse of the whole endpoint catalog (verified-first), optionally filtered to a category branch. Card shape is shared with the public registry surface.

get/v1/endpoints

Request

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

Query parameters

limitinteger

Max items per page (server-side cap applies).

Example:20
cursorstring

Cursor returned by the previous page.

supportsX402'true' | 'false'

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.

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.

Example:eip155:8453
readonly'true' | 'false'

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:creates,deletes
categorystring

Category node id to filter by (top group, leaf category, or provider node id from GET /public/v1/categories).

Example:twitter

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

Response

Catalog page

cursorstring

Opaque cursor for the next page. Absent on the last page.

totalinteger

Total number of enabled endpoints matching the underlying query, irrespective of pagination.

Example response

{
  "items": [
    {
      "provider": "exa",
      "endpoint": "/search"
    }
  ]
}

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