List remote Agent Skill target status

POST
/v1/skill/remote/targets

Return credential-free target metadata and desired/observed publication state for one scope.

Authorization

BearerAuth
AuthorizationBearer <token>

Static bearer token used when local Server authentication is enabled.

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/targets" \  -H "Content-Type: application/json" \  -d '{    "scope_id": "string"  }'
{  "targets": [    {      "target": {        "scope_id": "string",        "target_id": "string",        "display_name": "string",        "agent_kind": "codex",        "installation_scope": "project",        "delivery_mode": "agent_pull",        "installation_id": "string",        "state": "pending",        "receiver_version": "string",        "environment_fingerprint": "string",        "machine_hostname": "string",        "workspace_name": "string",        "last_seen_at": "2019-08-24T14:15:22Z",        "generation": 0      },      "publications": [        {          "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        }      ]    }  ]}

Record a bounded Skill usage observation POST

Validate an exact managed Skill Revision and capture immutable bounded usage Source evidence.

Create a remote Agent Skill target enrollment POST

Create a pending project target and return one short-lived enrollment code exactly once.