Record a bounded Skill usage observation

POST
/v1/skill/usage

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

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

application/json

application/json

curl -X POST "https://example.com/v1/skill/usage" \  -H "Content-Type: application/json" \  -d '{    "scope_id": "string",    "observation_id": "string",    "skill_ref": {      "family": "string",      "artifact_id": "string",      "revision": 1    },    "package_digest": "string",    "target_id": "string",    "selected": true,    "invoked": "true",    "validation": "passed",    "outcome": "success"  }'
{  "status": "accepted",  "source": {    "name": "string",    "source_id": "string"  },  "position": 1}

Propose an uploaded standard Skill package POST

Canonicalize exact ZIP bytes, store them once, and create a pending Candidate without LLM rewriting.

List remote Agent Skill target status POST

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