---
title: "List an upload on the marketplace"
method: POST
path: "/v1/aion/marketplace/list"
---

# List an upload on the marketplace

`POST /v1/aion/marketplace/list`

## Request

- Base URL: `https://api.payaion.com`
- URL: `https://api.payaion.com/v1/aion/marketplace/list`
- Auth: API key in header `X-Aion-Key`

Creates or updates a marketplace listing for a READY upload you own.
The upload must not expire within 30 minutes.
Max 50 active listings per principal.

## Request body

- object
  - `uploadId` string, required: ID of a READY upload you own
  - `title` string, required
  - `description` string, required
  - `tags` string[]
  - `category` 'reports' | 'datasets' | 'code' | 'media' | 'models' | 'prompts' | 'other', nullable

## Response `201`

Listing created or updated

- object
  - `listed` boolean, required
  - `uploadId` string, required
  - `url` string, uri, nullable: Market listing page URL (/m/{hash}) — null when the upload is not listed

## Other responses

- `401`: Invalid or missing credentials
- `403`: Scope denied or access forbidden
- `404`: Resource not found
- `422`: Upload not ready or expires too soon
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/payaion/apis/payaion-api.md) · [All operations](https://skmtc.dev/payaion/apis/payaion-api/llms.txt) · [OpenAPI document](https://skmtc.dev/payaion/apis/payaion-api/revisions/29927240cfc2?raw)