Invoke a capability served by this node

POST 
/v1/capabilities/call

Dispatch one unary capability call to this node's provider extensions (fabric-citizenship). The body is the typed call envelope (call id, capability id and exact version, the descriptor revision pinned at discovery, deadline, and the opaque payload). The payload is validated against the descriptor's input schema before the provider runs and the result against its output schema after. A syntactically valid envelope always gets HTTP 200 with a typed result: failures arrive as machine-readable error codes (not_found, version_mismatch, revision_mismatch, invalid_payload, invalid_result, payload_too_large, overloaded, timeout, provider_error) rather than transport errors. A body that does not parse as the envelope at all (malformed JSON, missing fields, out-of-range values) gets the standard 422, since there is no call id to correlate a typed result to. Callers normally use this through their extension context's call_capability rather than directly.

Request

Responses

200

Successful Response

422

Validation Error