Collections
Publishing

Publish a collection

Publish a collection as a public gallery with privacy-aware metadata handling. Choose a disclosure preset to control what metadata is exposed: share (full), portfolio (creative only), client (minimal), or archive (original preserved). Creates stable public URLs for all collection assets.

post/api/v1/collections/{collectionH}/publish

Request

  • Base URL: https://numonic.ai
  • URL: https://numonic.ai/api/v1/collections/{collectionH}/publish
  • Auth: API key in header x-api-key

Path parameters

collectionHstring required

Collection hash (40-char hex SHA-1)

Example:a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2

Request body

privacyPreset'share' | 'portfolio' | 'client' | 'archive'

Privacy preset controlling which metadata is included when publishing or exporting: share (full), portfolio (creative only), client (minimal), archive (original preserved)

visibility'public' | 'unlisted' | 'private'

Reachability/listing tier for a published collection (ORTHOGONAL to privacyPreset): public (listed + slug + hash), unlisted (hash-only, never listed), private (not publicly reachable)

publishPreset'web-standard' | 'high-quality' | 'thumbnail'

Image optimization preset applied during collection publish

Response

Collection published

messagestring required

Human-readable success message

Example response

{
  "message": "Operation completed successfully"
}

Changes

No recorded changes to this operation across all 1 revision of this API.