Record an exact remote Skill delivery Receipt

POST
/v1/skill/remote/receipt

Update latest observed state only after credential, generation, Artifact, operation, and digest validation.

Authorization

TargetBearerAuth
AuthorizationBearer <token>

Per-target credential issued once during remote Receiver enrollment.

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

curl -X POST "https://example.com/v1/skill/remote/receipt" \  -H "Content-Type: application/json" \  -d '{    "operation": "install",    "generation": 0,    "artifact": {      "family": "string",      "artifact_id": "string",      "revision": 1    },    "expected_tree_digest": "string",    "observed_tree_digest": "string",    "outcome": "succeeded",    "failure_state": "delivery_failed",    "error_code": "string",    "receiver_version": "string",    "environment_fingerprint": "string"  }'
{  "accepted": true,  "stale": true,  "publication": {    "scope_id": "string",    "target_id": "string",    "artifact_id": "string",    "desired_state": "published",    "desired_revision": 1,    "desired_tree_digest": "string",    "observed_revision": 1,    "observed_tree_digest": "string",    "observed_generation": 0,    "state": "unpublished",    "last_error_code": "string",    "observed_at": "2019-08-24T14:15:22Z",    "generation": 0  }}

Download the exact package desired by a remote target POST

Return canonical ZIP bytes only when target, generation, Artifact Revision, and package reference all match.

Scan configured external Skill roots POST

Replace the current host-local Registry projection without copying or rewriting package content.