Mediloop
APIsMarketplace APIPublish guard

Publish guard

GET

Validate whether a catalog item and listing are eligible for public Marketplace publication.

/catalog/{id}/publish-guard

Authentication

OAuth 2.0

Permissions

marketplace:read

Rate limit

120 requests / min

Response

200 OK

Overview

Validate whether a catalog item and listing are eligible for public Marketplace publication.

Endpoint

GET /catalog/{id}/publish-guard
GET https://api.mediloop.com/v1/catalog/lst_123/publish-guard
Authorization: Bearer $ACCESS_TOKEN
X-Tenant-Id: $TENANT_ID

Authentication

Required scope: marketplace:read. Access is also constrained by seller organization, tenant membership and Marketplace entitlement.

Request body

FieldTypeRequiredDescription
idempotency_keystringRecommendedPrevents duplicate business actions
reference_idstringVariesRelated Marketplace resource
metadataobjectNoIntegration metadata

Example request

cURL
curl -X GET "https://api.mediloop.com/v1/catalog/lst_123/publish-guard" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Accept: application/json"
Example response200 OK
{
  "data": {
    "id": "mkt_123",
    "status": "active",
    "updated_at": "2026-08-19T07:00:00Z"
  }
}

Example response

Marketplace responses use stable resource IDs and explicit lifecycle states so integrations can reconcile safely.

Responses

HTTPMeaning
200Success
201Created
400Invalid request
401Authentication required
403Insufficient permissions
404Resource not found
409Business-state conflict
429Rate limit exceeded