capability-proxy

Native streaming hop for local execute: the request body is the outbound fetch body (raw bytes, no JSON wrapper).

Native streaming hop for local execute: the request body is the outbound fetch body (raw bytes, no JSON wrapper). Hop metadata is in X-Kody-Gateway-Url (required), X-Kody-Gateway-Method, X-Kody-Gateway-Package-Id, X-Kody-Gateway-Headers, and x-kody-secret-resolution. A successful response is the upstream HTTP response, streamed — not { status, headers, bodyBase64 }. Requires org:execute and a scoped API token or CLI MCP OAuth bearer. Not available as a JSON MCP api invoke; use POST /v1/capability-proxy/gateway-fetch.

Org permission: org:execute.

post/v1/capability-proxy/gateway-fetch

Request

  • Base URL: https://api.kody.codes
  • URL: https://api.kody.codes/v1/capability-proxy/gateway-fetch
  • Auth: HTTP bearer

Headers

X-Kody-Gateway-Urlstring required

Absolute outbound URL. May contain literal {{secret:…}} / {{integration-token:…}} placeholders.

X-Kody-Gateway-Methodstring

Outbound HTTP method. Defaults to GET.

X-Kody-Gateway-Package-Idstring

Claimed package stamp. Origin verifies package:execute for that id.

X-Kody-Gateway-Headersstring

JSON object of outbound header name → string value. Invalid JSON or non-string values are 400 invalid_request.

x-kody-secret-resolutionstring

on (default), headers-only, or off. Origin strips this header before the request leaves.

Response

Upstream HTTP response: status, headers, and body, streamed. Not a JSON envelope. Upstream 4xx/5xx (including 429) are forwarded as the stream, not the JSON Error envelope.

Changes

No recorded changes to this operation across all 1 revision of this API.