Skip to Content
ReferenceAPICatalogueUpdate an item

Catalogue API

Update a catalogue item

Update a product or service in the current workspace catalogue.

PATCH/v1/catalogue/items/{itemId}
capability catalogue.items.update · v1operational dataserver-scoped workspace

Request

Path, query, and JSON body fields accepted by this operation.

  • itemIdstring<uuid>required
    path
  • kind"product" | "service"
    body
  • handlestring
    bodymin length 1max length 120
  • namestring
    bodymin length 1max length 160
  • descriptionstring | null
    bodymax length 5000
  • referencestring | null
    bodymin length 1max length 120
  • serviceDurationMinutesinteger | null
    bodymin 5max 1440
  • status"draft" | "active" | "archived"
    body

Response

Successful responses use Dawn's data envelope.

  • dataCatalogueItemrequired
    • idstring<uuid>required
    • workspaceIdstring<uuid>required
    • kind"product" | "service"required
    • handlestringrequired
      min length 1max length 120
    • namestringrequired
      min length 1max length 160
    • descriptionstring | nullrequired
      max length 5000
    • referencestring | nullrequired
      min length 1max length 120
    • serviceDurationMinutesinteger | nullrequired
      min 5max 1440
    • status"draft" | "active" | "archived"required
    • createdAtstring<date-time>required
    • updatedAtstring<date-time>required
  • metaobject

Errors

Error responses use the shared error envelope.

  • 404The catalogue item could not be found.
  • 409A catalogue item already uses this handle or reference.
  • 422The catalogue item is invalid.
  • 503The catalogue item could not be saved.
Last updated on