PKU harness
CloudAPI reference

Functions (planned)

Server functions declared in a plugin's `CloudManifest.functions`. Planned for stage 6.

POST
/v1/fn/{plugin}/{name}

Planned (stage 6). The reference server answers 501 unsupported until then. Runs a function the plugin declared in CloudManifest.functions, on the user's provider. A function is name@version; the server keeps the previous major for 90 days. Default limit: 60 calls per minute.

Authorization

pluginToken
headerAuthorizationBearer <token>

Token from POST /v1/auth/token (10 minutes, one device + one plugin + services). Channel owner endpoints require the token of the device and plugin that opened the channel.

Path Parameters

plugin*string

Registry id rule, plus mcp-… host ids for remote plugins.

Match^[a-z0-9][a-z0-9-]{1,63}$
name*string
Match^[a-zA-Z][a-zA-Z0-9_]{0,63}$

Request Body

application/json
  1. body
input?unknown

Any JSON value, validated by the function's input schema.

version?integer
Range1 <= value

Response Body

The function output.

application/json
  1. response
output?unknown

Any JSON value, shaped by the function's output schema.

Example Request
curl -X POST 'https://cloud.example.org/v1/fn/string/string' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response
{  "output": null}