# Create Controlled Vocabulary

Create a Controlled Vocabulary. User must have permission to create a controlled vocabulary.

Response will contain the object of the metadata definition attributes, such as id, name, type and search fields, etc.

Average Response Time: 585ms

Endpoint: POST /metadata/vocabulary
Version: 1.5
Security: ApiKeyAuth, BasicAuth

## Header parameters:

  - `X-API-Key` (string, required)
    Customer-specific API key required to invoke API.

  - `Authorization` (string, required)
    Provided by Authentication Token creation operation

  - `Content-Type` (string, required)
    Enum: "application/json"

## Request fields (application/json):

  - `name` (string)
    Vocabulary Name
    Example: "Color List"

  - `values` (array)
    List of vocabulary values
    Example: ["Red","Blue"]

## Response 200 fields (application/json):

  - `createdEpoch` (integer)
    Create time in milliseconds
    Example: 1613877219787

  - `customerId` (string)
    Customer Id
    Example: "157167185123342"

  - `lastUpdatedEpoch` (integer)
    Update time in milliseconds
    Example: 1613877219787

  - `metadataDefinitionId` (string)
    Field ID
    Example: "6c921f5c-24c2-40b9-8718-3ad2d4a6be54"

  - `metadataDefinitionName` (string)
    Field Name
    Example: "Colors"

  - `metadataDefinitionSearchField` (string)
    Map search field for this metadata definition
    Example: "colors"

  - `metadataDefinitionType` (string)
    Example: "controlledVocabulary"

  - `metadataDocument` (object)
    Vocabulary metadata

  - `metadataDocument.values` (array)

  - `metadataDocument.values.valueId` (string)

  - `metadataDocument.values.valueName` (string)
    Example: "Red"

  - `metadataDocument.searchable` (boolean)
    Toggle searchability

## Response 400 fields (application/json):

  - `message` (string)

  - `detail` (string)

## Response 401 fields (application/json):

  - `message` (string)

  - `detail` (string)

## Response 403 fields (application/json):

  - `message` (string)

  - `detail` (string)