---
title: "Publish a capsule as a skill (enabling it when needed), optionally under a chosen name"
method: POST
path: "/api/preview/capsules/{id}/skill/publish"
tags: ["capsule"]
---

# Publish a capsule as a skill (enabling it when needed), optionally under a chosen name

`POST /api/preview/capsules/{id}/skill/publish`

## Request

- Base URL: `https://symbol.chat` (the document declares no server; this is the origin it was published from)
- URL: `https://symbol.chat/api/preview/capsules/{id}/skill/publish`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `__Secure-next-auth.session-token`
  - OAuth 2
    - Authorization code: `https://mcp.symbol.chat/authorize`
    - Token URL: `https://mcp.symbol.chat/token`

## Path parameters

- `id` string, required: UUID v4 string

## Request body

- object
  - `name` string, nullable: The skill's name: lowercase letters, digits and single hyphens, at most 64 characters, not `claude` or `anthropic`.

## Response `200`

Successful response

- object
  - `status` object, required
    - `blockedCode` string, nullable, required
    - `blockedReason` string, nullable, required
    - `blockers` object[], required
    - `delivery` object, nullable, required
    - `derivedName` string, nullable, required
    - `drifted` boolean, required
    - `enabled` boolean, required
    - `inMarketplace` boolean, required
    - `nameFrozenMismatch` boolean, required
    - `nameSource` 'chosen' | 'derived', required
    - `publishable` boolean, required
    - `publishedVersionNum` integer, nullable, required
    - `republishRefused` string, nullable
    - `skillName` string, nullable, required
    - `state` 'draft' | 'published' | 'stale' | 'pending' | 'failed' | 'unknown', nullable, required
    - `warnings` string[], required

## Changes

- **2026-10-27** `3a2c4ebeab51`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/symbol/apis/symbol-api/changes/api/preview/capsules/:id/skill/publish/post.md)

---

[API](https://skmtc.dev/symbol/apis/symbol-api.md) - [All operations](https://skmtc.dev/symbol/apis/symbol-api/llms.txt) - [OpenAPI document](https://skmtc.dev/symbol/apis/symbol-api/revisions/3a2c4ebeab51?raw)