# Vocabulary Updated

Receive a notification when a Metadata Vocabulary list (Controlled Vocabulary) is updated in Tenovos.  This event applies to values being added to, removed from, or renamed in an existing vocabulary.

Endpoint: POST metadata.vocabulary.updated
Version: v1.0
Security: OAuth2

## Request fields (application/json):

  - `eventType` (string)
    Combination of the Topic and the Event
    Example: "metadata.vocabulary.updated"

  - `event` (object)
    Object containing event information and the user who triggered the event.

  - `event.id` (string)
    Unique identifier of the webhook event itself
    Example: "some-event-type-d231cf1d-86b2-436e-95de-b745c39d2ed5"

  - `event.time` (string)
    Date/Time that the webhook event occurred.
    Example: "2024-05-09T17:55:28.462Z"

  - `event.user` (object)

  - `event.user.id` (string)
    The Tenovos User ID for the user who caused the event
    Example: "7d675ef0-f423-11e9-8071-89c0c405214e"

  - `event.user.firstName` (string)
    First Name of the User
    Example: "Erlich"

  - `event.user.lastName` (string)
    Last Name of the User
    Example: "Bachman"

  - `vocabulary` (object)

  - `vocabulary.id` (string)
    Metadata Definition ID of the Vocabulary list.
    Example: "197f0ebb-5e82-4e8d-97f4-94f1e1aa3d2e"

  - `vocabulary.name` (object)
    Metadata Definition Name current and previous values.

  - `vocabulary.name.previous` (string)
    The value for the name of the Vocabulary list prior to the associated update
    Example: "Boats"

  - `vocabulary.name.current` (string)
    The value for the name of the Vocabulary list after the associated update
    Example: "Boat Type"

  - `vocabulary.values` (object)

  - `vocabulary.values.added` (array)

  - `vocabulary.values.added.id` (string)
    Vocabulary ID
    Example: "15e277db-ab3f-4baa-9913-3d75e9e22b58"

  - `vocabulary.values.added.value` (string)
    The text value of the vocabulary items
    Example: "Pontoon"

  - `vocabulary.values.removed` (array)

  - `vocabulary.values.updated` (array)

  - `vocabulary.values.updated.value` (object)
    Provides both the current and previous values for a vocabulary item that was updated.

  - `vocabulary.values.updated.value.current` (string)
    The current value applied to the vocabulary item, after the associated update was made.
    Example: "New Hampshire"

  - `vocabulary.values.updated.value.previous` (string)
    The previous value applied to the vocabulary item, prior to the associated update being made.
    Example: "NH"