pc source add

POST
/v1/source-management/add

Use the discovered write or collect capability and version. Collect capabilities require an explicit instance_id. Write runs in the Server using loaded Definition and Projection implementations, without an instance or management service. Write waits for Source references or an error in the original call; no durable request or status query is created. Collect establishes or reuses a persistent target and never resumes a stopped target. No mode or idempotency_key is accepted; write retries use the underlying Source identity rules.

Authorization

BearerAuth
AuthorizationBearer <token>

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

In: header

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

application/json

curl -X POST "https://example.com/v1/source-management/add" \  -H "Content-Type: application/json" \  -d '{    "scope_id": "string",    "capability": "string",    "capability_version": "string",    "input": {}  }'
{  "target_id": "string",  "tracking": "enabled",  "result": {    "outcome": "saved",    "source_refs": [      {        "source_type": "string",        "source_id": "string",        "locator": {          "kind": "sequence",          "sequence": 0        }      }    ]  },  "error": "string",  "instance_id": "string",  "capability": "string",  "capability_version": "string",  "availability": "online",  "updated_at": "string",  "kind": "collect",  "enabled": true,  "source_refs": [    {      "source_type": "string",      "source_id": "string",      "locator": {        "kind": "sequence",        "sequence": 0      }    }  ],  "last_submitted_at": "string"}