Catalog

1 endpointEnglish only

List the catalog of predefined grid items, domains and templates

get/predefined-itemsexperimentalSession required

Reference data for building grids by script, the same catalog POST /workshops/{workshopId}/grids/ai-draft draws on: items are grouped by domain and by template, each by slug or id match with no referential enforcement, so a template's itemIds or a domain's slug may point at something absent from this response if the catalog changes. Not workshop-scoped, the same response for every caller. In production this returns on the order of 200 items across 16 domains and 27 templates; the example below is a truncated slice.

Responses

  • 200Success
    FieldTypeRequiredConstraintsDescription
    itemsarray of PredefinedGridItemYes--
    domainsarray of PredefinedItemDomainYes--
    templatesarray of GridTemplateYes--
    Example
    {
  "items": [
    {
      "id": "labor",
      "emoji": "🔧",
      "label": {
        "en": "Labor",
        "pl": "Robocizna"
      },
      "unit": "hour",
      "tags": [
        "labor"
      ]
    }
  ],
  "domains": [
    {
      "slug": "general",
      "label": {
        "en": "General",
        "pl": "Ogólne"
      }
    }
  ],
  "templates": [
    {
      "slug": "common-fees-and-add-ons",
      "domainSlug": "general",
      "name": {
        "en": "Common Fees & Add-ons",
        "pl": "Typowe opłaty i dodatki"
      },
      "description": {
        "en": "Labor, callouts, deposits and delivery, ready to mix into any grid.",
        "pl": "Robocizna, dojazdy, zaliczki i dostawa - gotowe, by dodać do dowolnego cennika."
      },
      "itemIds": [
        "labor"
      ]
    }
  ]
}
  • 401Not authenticated

    No body.

Example request

curl -X GET 'https://mercastra.cloud/api/predefined-items' \
  -H 'Cookie: session=<session cookie>'