Propose a skill (deployed-agent data plane)

Agent self-authoring endpoint hit by the propose_skill runtime tool. Review-by-default; auto-publishes only under the owner-set opt-out. NOT the admin create path.

Authentication

AuthorizationBearer

API key or Clerk session token

Request

This endpoint expects an object.

bodystringRequired

descriptionstringRequired

namestringRequired

proposingAgentExecutionIdstringRequired

proposingAgentIdstringRequired

capabilitiesmap from strings to anyOptional

Response

Proposal outcome

Errors

400

Bad Request Error

401

Unauthorized Error

422

Unprocessable Entity Error

$	curl -X POST https://api.runtype.com/v1/skills/propose \
>	-H "Authorization: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"body": "def greet_user(name):\n return f\"Hello, {name}! Welcome to Runtype.\"",
>	"description": "A skill that generates a personalized greeting message for a user.",
>	"name": "Personalized Greeting Skill",
>	"proposingAgentExecutionId": "exec-9f8b7c6d-1234-4a56-b789-0a1b2c3d4e5f",
>	"proposingAgentId": "agent-4e5f6a7b-89cd-0123-4567-89abcdef0123"
>	}'

$	curl -X POST https://api.runtype.com/v1/skills/propose \
>	-H "Authorization: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"body": "def greet_user(name):\n return f\"Hello, {name}! Welcome to Runtype.\"",
>	"description": "A skill that generates a personalized greeting message for a user.",
>	"name": "Personalized Greeting Skill",
>	"proposingAgentExecutionId": "exec-9f8b7c6d-1234-4a56-b789-0a1b2c3d4e5f",
>	"proposingAgentId": "agent-4e5f6a7b-89cd-0123-4567-89abcdef0123"
>	}'