RArastro-ai
Catalogs

Create Catalog Public

Create a new catalog (API key or user token).

post/public/catalogs

Request

  • Base URL
    https://catalogapi.rastro.ai/api
  • Auth
    HTTP bearer

Headers

X-Organization-Idstring nullable

Request body

namestring required

Catalog name

descriptionstring nullable

Optional catalog description

unique_id_fieldstring required

Legacy compatibility field required by the public create request. Include the intended business key, such as sku, in schema and item data; this request field is not a separate runtime selector.

product_id_fieldstring nullable

Field name to use as product identifier

auto_evolve_schemaboolean

Allow automatic schema evolution

strict_modeboolean

Reject unknown fields

product_enabledboolean

Whether this catalog supports product variants

schema_definitionobject required

Initial JSON Schema for the catalog (from preview), including properties and required

validation_rulesobject nullable

Catalog-level validation rules to copy or override

catalog_mdstring nullable

Markdown catalog context to copy or override

master_catalog_idstring nullable

Explicit master catalog to inherit defaults from

use_master_catalog_defaultsboolean

Whether to inherit defaults from the org's default master catalog

Response

Successful Response

idstring required
organization_idstring required
namestring required
descriptionstring nullable
current_schema_versionstring required
unique_id_fieldstring required
product_id_fieldstring nullable
auto_evolve_schemaboolean required
strict_modeboolean required
product_enabledboolean required
item_countinteger required
created_by_user_idstring required
created_atstring date-time required
updated_atstring date-time nullable

Changes

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