---
title: "Publish a registry skill through the hosted admin surface"
method: POST
path: "/v1/admin/registry/publish"
tags: ["admin"]
---

# Publish a registry skill through the hosted admin surface

`POST /v1/admin/registry/publish`

## Request

- Base URL: `https://api.runx.ai`
- URL: `https://api.runx.ai/v1/admin/registry/publish`
- Auth: HTTP bearer

## Request body

- AdminRegistryPublishRequest
  - `owner` string, required: An existing publisher's namespace; administrative publication never creates one.
  - `version` string
  - `markdown` string, required
  - `profile_document` string
  - `package_files` HostedSkillPackageFile[]
    - `path` string, required: Relative allowlisted package path. Root SKILL.md and run.yaml use their dedicated fields.
    - `content` string, required: UTF-8 file content.
  - `trust_tier` 'first_party' | 'verified' | 'community': The verification authority's admission for this version; community when absent.
  - `harness` HarnessPublishSummary, required
    - `status` 'passed' | 'failed' | 'not_declared', required
    - `case_count` integer, required
    - `assertion_error_count` integer, required
    - `assertion_errors` string[], required
    - `case_names` string[], required
    - `receipt_ids` string[], required
    - `graph_case_count` integer
    - `evidence_id` string
    - `evidence_url` string, uri

## Response `200`

Published registry skill.

- AdminRegistryPublishEnvelope
  - `status` 'success', required
  - `publish` object, required
  - `harness` HarnessPublishSummary, required
    - `status` 'passed' | 'failed' | 'not_declared', required
    - `case_count` integer, required
    - `assertion_error_count` integer, required
    - `assertion_errors` string[], required
    - `case_names` string[], required
    - `receipt_ids` string[], required
    - `graph_case_count` integer
    - `evidence_id` string
    - `evidence_url` string, uri

## Other responses

- `400`: Validation error.
- `401`: Unauthorized.
- `403`: Forbidden.
- `503`: Registry store unavailable.

---

[API](https://skmtc.dev/runx/apis/runx-hosted-api.md) · [All operations](https://skmtc.dev/runx/apis/runx-hosted-api/llms.txt) · [OpenAPI document](https://skmtc.dev/runx/apis/runx-hosted-api/revisions/6c940d8edacc?raw)