Skip to main content
POST
Get full endpoint details

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
provider
string
required

Provider slug.

Minimum string length: 1
Example:

"exa"

endpoint
string
required

Endpoint path.

Minimum string length: 1
Example:

"/search"

Response

Endpoint details

provider
string
required

Provider slug (e.g., "apify").

endpoint
string
required

Endpoint path.

description
string
required
tags
string[]
required

Tags for scoring and filtering (e.g., ["verified", "no-markup"]). no-markup = priced at the provider's standard rate with no platform fee added.

categories
string[]
required

Depth-2 category paths — authored functional + derived provider (e.g. ["social-media/twitter"]). Empty when uncategorized.

providerName
string

Human-readable provider name (e.g., "Apify").

summary
string
method
enum<string>

HTTP method for this endpoint.

Available options:
GET,
POST,
PUT,
DELETE,
PATCH
price
object

User-facing price (markup applied).

docUrl
string

Provider documentation URL.

notes
string[]

Operator-curated notes for agents — quirks, pitfalls, best practices.

promotion
object

Present ONLY on a limited-time promotion endpoint (/promo/...): a discounted copy of baseEndpoint — or a standalone offer without one — with stricter per-workspace limits, available while the campaign lasts.

metrics
object

Recent operational health (server-computed from run analytics). Omitted when analytics is unavailable.

hints
object

Agent guidance map (phrase → hint), polymorphic by client: rendered command string for cli/api/mcp, structured target for web. Omitted for unknown clients.

input
object

Structured input — JSON Schema per param location (path, query, body).