---
title: "Publish skill to marketplace"
method: POST
path: "/api/store/skills/submissions"
tags: ["v2", "store", "private"]
---

# Publish skill to marketplace

`POST /api/store/skills/submissions`

Submit one of the caller's own library skills for marketplace review.

## Request body

- SkillSubmissionRequest — Publish one of the caller's own library skills as a marketplace listing.
  - `skill_name` string, required — Slug of the caller's library skill to publish.
  - `categories` string[], required
  - `required_providers` string[] — Integrations the skill's instructions assume are connected.
  - `changes_summary` string, nullable

## Response `201`

Successful Response

- SkillSubmission
  - `skill_listing_version_id` string, required
  - `slug` string, required
  - `name` string, required
  - `description` string, required
  - `categories` string[], required
  - `required_providers` string[], required
  - `version` integer, required
  - `status` 'DRAFT' | 'PENDING' | 'APPROVED' | 'REJECTED', required
  - `review_comments` string, nullable
  - `is_live` boolean, required — Whether this version is the one the marketplace serves.
  - `files` SkillPackageFile[] — Files beside the submitted SKILL.md, so a reviewer sees what a package ships before approving it.
    - `path` string, required
    - `size_bytes` integer, required
    - `mime_type` string, nullable
    - `is_executable` boolean

## Other responses

- `401` — Authentication required
- `404` — Skill not in the caller's library
- `422` — Validation Error
- `428` — Marketplace profile required, or slug taken

## Changes

- **2026-09-15** `e78ea4d13921` — 1 info
  - added the optional property `files` to the response with the `201` status
- **2026-09-15** `926547c24ad4` — 1 warning
  - removed the optional property `files` from the response with the `201` status
- **2026-09-15** `46e56aee180f` — 1 info
  - added the optional property `files` to the response with the `201` status
- **2026-09-09** `b89addd31411` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/changes/api/store/skills/submissions/post.md)

---

[API](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server.md) · [All operations](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/llms.txt) · [OpenAPI document](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/revisions/b84a51b99815?raw)