---
title: "UpdateEntry Catalog V2"
method: PUT
path: "/v2/catalog_entries/{id}"
tags: ["Catalog V2"]
---

# UpdateEntry Catalog V2

`PUT /v2/catalog_entries/{id}`

Updates an existing catalog entry.

## Path parameters

- `id` string, required

## Request body

- CatalogV2UpdateEntryRequestBody
  - `aliases` string[] — Optional aliases that can be used to reference this entry
  - `attribute_values` object, required — Values of this entry
  - `external_id` string — An optional alternative ID for this entry, which is ensured to be unique for the type
  - `name` string, required — Name is the human readable name of this entry
  - `rank` integer — When catalog type is ranked, this is used to help order things

## Response `200`

OK response.

- CatalogV2UpdateEntryResponseBody
  - `catalog_entry` CatalogEntryV2, required
    - `aliases` string[], required — Optional aliases that can be used to reference this entry
    - `archived_at` string, date-time — When this entry was archived
    - `attribute_values` object, required — Values of this entry
    - `catalog_type_id` string, required — ID of this catalog type
    - `created_at` string, date-time, required — When this entry was created
    - `external_id` string — An optional alternative ID for this entry, which is ensured to be unique for the type
    - `id` string, required — ID of this catalog entry
    - `name` string, required — Name is the human readable name of this entry
    - `rank` integer, required — When catalog type is ranked, this is used to help order things
    - `updated_at` string, date-time, required — When this entry was last updated
  - `catalog_type` CatalogTypeV2, required
    - `annotations` object, required — Annotations that can track metadata about this type
    - `categories` string[], required — What categories is this type considered part of
    - `color` 'yellow' | 'green' | 'blue' | 'violet' | 'pink' | 'cyan' | 'orange', required — Sets the display color of this type in the dashboard
    - `created_at` string, date-time, required — When this type was created
    - `description` string, required — Human readble description of this type
    - `dynamic_resource_parameter` string — If this is a dynamic catalog type, this will be the unique parameter for identitfying this resource externally.
    - `estimated_count` integer — If populated, gives an estimated count of entries for this type
    - `icon` 'alert' | 'bolt' | 'box' | 'briefcase' | 'browser' | 'bulb' | 'calendar' | 'clock' | 'cog' | 'components' | 'database' | 'doc' | 'email' | 'escalation-path' | 'files' | 'flag' | 'folder' | 'globe' | 'money' | 'server' | 'severity' | 'status-page' | 'store' | 'star' | 'tag' | 'user' | 'users', required — Sets the display icon of this type in the dashboard
    - `id` string, required — ID of this catalog type
    - `is_editable` boolean, required — Catalog types that are synced with external resources can't be edited
    - `last_synced_at` string, date-time — When this type was last synced (if it's ever been sync'd)
    - `name` string, required — Name is the human readable name of this type
    - `ranked` boolean, required — If this type should be ranked
    - `registry_type` string — The registry resource this type is synced from, if any
    - `required_integrations` string[] — If populated, the integrations required for this type
    - `schema` CatalogTypeSchemaV2, required
      - `attributes` CatalogTypeAttributeV2[], required — Attributes of this catalog type
        - `array` boolean, required — Whether this attribute is an array
        - `backlink_attribute` string — The attribute to use (if this is a backlink)
        - `id` string, required — The ID of this attribute
        - `mode` '' | 'manual' | 'external' | 'internal' | 'dynamic' | 'backlink' | 'path', required — Controls how this attribute is modified
        - `name` string, required — Unique name of this attribute
        - `path` CatalogTypeAttributePathItemV2[] — The path to use (if this is a path attribute)
          - `attribute_id` string, required — the ID of the attribute to use
          - `attribute_name` string, required — the name of the attribute to use
        - `type` string, required — Catalog type name for this attribute
      - `version` integer, required — The version number of this schema
    - `semantic_type` string, required — Semantic type of this resource (unused)
    - `source_repo_url` string — The url of the external repository where this type is managed
    - `type_name` string, required — The type name of this catalog type, to be used when defining attributes. This is immutable once a CatalogType has been created. For non-externally sync types, it must follow the pattern Custom["SomeName "]
    - `updated_at` string, date-time, required — When this type was last updated

---

[API](https://skmtc.net/incident/apis/incident-io.md) · [All operations](https://skmtc.net/incident/apis/incident-io/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/incident/incident-io/revisions/602fc25ddd76/schema)