Propose managed Skill content

POST
/v1/skill/propose

Persist a pending managed Skill Candidate without creating an Artifact Revision.

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

curl -X POST "https://example.com/v1/skill/propose" \  -H "Content-Type: application/json" \  -d '{    "scope_id": "string",    "proposal": {      "name": "string",      "description": "string",      "instructions": "string",      "validation": [        "string"      ]    },    "source_refs": [      {        "name": "string",        "source_id": "string"      }    ],    "artifact_refs": [      {        "family": "string",        "artifact_id": "string",        "revision": 1      }    ]  }'
{  "candidate_id": "string",  "version": 1,  "family": "experience",  "status": "pending",  "proposal": {    "situation": "string",    "action": "string",    "outcome": "string",    "lesson": "string"  },  "source_refs": [    {      "name": "string",      "source_id": "string"    }  ],  "artifact_refs": [    {      "family": "string",      "artifact_id": "string",      "revision": 1    }  ],  "target": {    "family": "string",    "artifact_id": "string",    "revision": 1  },  "reason": "string",  "result_artifact": {    "family": "string",    "artifact_id": "string",    "revision": 1  },  "decision_reason": "string"}

Get an exact Experience Revision POST

Read approved Experience content and its exact direct evidence.

Generate a managed Skill Candidate POST

Use the configured model with an explicit provenance shape; persist only a schema-valid pending Candidate.