Authenticated instance control, permission checks and durable result exchange

POST
/v1/source-management/instances/{instance_id}/{operation}

Served by the optional standalone Source manager. Instances initiate every exchange; this is not a Server or public MCP endpoint. The operation path chooses owner/connect/poll/reply/sync/execution/results/stopped-targets/close and the applicable fields. Source observations continue to go directly to the PC Server.

Authorization

BearerAuth
AuthorizationBearer <token>

Bearer credential resolved to an opaque authenticated Principal by the Server deployment.

In: header

Path Parameters

instance_id*string
Match^[A-Za-z0-9_.-]+$
Length1 <= length <= 256
operation*string

Value in

  • "owner"
  • "connect"
  • "poll"
  • "reply"
  • "sync"
  • "execution"
  • "results"
  • "stopped-targets"
  • "close"

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/source-management/instances/string/owner" \  -H "Content-Type: application/json" \  -d '{}'
{}