Publish listing
POSTPublish an eligible listing to make it visible and purchasable in the Marketplace.
/listings/{id}/publishAuthentication
OAuth 2.0
Permissions
marketplace:write
Rate limit
120 requests / min
Response
201 Created
Overview
Publishing runs the Marketplace publish guard first. Only compliant, complete and entitled listings can become publicly visible.
Publish guard
| Check | Requirement |
|---|---|
Entitlement | Seller has Marketplace publishing access |
Product class | Public-sale eligible |
Required data | Title, price, imagery and category complete |
Listing state | Draft or pending review |
Inventory | Valid availability configuration |
Endpoint
POST /listings/{id}/publish
POST https://api.mediloop.com/v1/listings/lst_123/publish
Authorization: Bearer $ACCESS_TOKEN
X-Tenant-Id: $TENANT_IDAuthentication
Required scope:
marketplace:write. Access is also constrained by seller organization, tenant membership and Marketplace entitlement.Parameters
| Field | Type | Required | Description |
|---|---|---|---|
page | integer | No | Page number |
limit | integer | No | Items per page |
status | string | No | Filter by status |
q | string | No | Search query |
Example request
cURL
curl -X POST "https://api.mediloop.com/v1/listings/lst_123/publish" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"metadata":{"source":"erp"}}'Example response200 OK
{
"data": {
"id": "mkt_123",
"status": "published",
"updated_at": "2026-08-19T07:00:00Z"
}
}Example response
Marketplace responses use stable resource IDs and explicit lifecycle states so integrations can reconcile safely.
Buyer preview
Published
Digital thermometer
Public-safe health device • Seller listing preview
€29.90
Responses
| HTTP | Meaning |
|---|---|
200 | Success |
201 | Created |
400 | Invalid request |
401 | Authentication required |
403 | Insufficient permissions |
404 | Resource not found |
409 | Business-state conflict |
429 | Rate limit exceeded |