Reconcile a remote Agent Skill target

POST
/v1/skill/remote/reconcile

Authenticate one target and return only latest-generation idempotent install or unpublish actions.

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

curl -X POST "https://example.com/v1/skill/remote/reconcile" \  -H "Content-Type: application/json" \  -d '{    "observations": [      {        "artifact": {          "family": "string",          "artifact_id": "string",          "revision": 1        },        "tree_digest": "string",        "actual_tree_digest": "string",        "skill_name": "string",        "applied_generation": 0      }    ],    "receiver_version": "string"  }'
{  "scope_id": "string",  "target_id": "string",  "actions": [    {      "operation": "install",      "generation": 0,      "artifact": {        "family": "string",        "artifact_id": "string",        "revision": 1      },      "tree_digest": "string",      "skill_name": "string",      "package": {        "tree_digest": "string",        "archive_digest": "string",        "file_count": 1,        "uncompressed_size": 1,        "archive_size": 1      },      "expected_local": {        "artifact": {          "family": "string",          "artifact_id": "string",          "revision": 1        },        "tree_digest": "string",        "actual_tree_digest": "string",        "skill_name": "string",        "applied_generation": 0      },      "blocked_error_code": "string"    }  ]}

Set remote target Skill desired absence POST

Advance desired state without claiming that any remote directory has already been removed.

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.