Skip to main content

Publish Module

Publishes an HDP module to the marketplace, making it visible to all users. This endpoint requires authentication.

Endpoint

POST /modules/{id}/publish

Authentication

This endpoint requires authentication using an API key:
X-API-KEY: your-herodotus-cloud-api-key-here

Path Parameters

ParameterTypeDescription
idstringThe unique module ID (ULID)

Example Request

curl -X POST https://staging.hdp.api.herodotus.cloud/modules/01JPJ03YJT1A93D6NF56G4GVEQ/publish \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: your-herodotus-cloud-api-key-here"

Response

Success Response (200 OK)

{
  "message": "Module published to marketplace"
}

Not Found Response (404)

{
  "error": "Module not found"
}

Unauthorized Response (401)

{
  "error": "Missing Herodotus Cloud X-API-KEY header"
}

Notes

  • Authentication is required for this endpoint
  • Publishing a module makes it visible in the marketplace
  • Published modules can be discovered by all users
  • Use the Unpublish Module endpoint to remove a module from the marketplace