diff --git a/reference/Reference_test.yaml b/reference/Reference_test.yaml
index daad8ab..a337f4c 100644
--- a/reference/Reference_test.yaml
+++ b/reference/Reference_test.yaml
@@ -406,11 +406,14 @@ paths:
   "/custom_fields.{format}":
     post:
       summary: Create CustomField
+      operationId: createCustomField
+      description: Use this method to create a new custom field.<br/>
+       You can specify custom fields for issues, projects or users. This custom field will then be only available for the specified entity within the specified project <br/>
       tags:
       - Custom field
       parameters:
       - name: format
-        description: specify format of response
+        description: Specify format of response
         in: path
         required: true
         schema:
@@ -12506,12 +12509,12 @@ components:
       properties:
         name:
           type: string
-          example: auta
-          description: Name of custom field
+          example: Internal identifying number shown to users
+          description: Name of the custom field
         field_format:
           type: string
           example: list
-          description: Format
+          description: Format of the custom field
           enum:
           - string
           - text
@@ -12541,47 +12544,47 @@ components:
           - flag
         regexp:
           type: string
-          description: Regular expression
+          description: Regular expression for field validation
         min_length:
           type: integer
-          description: Minimum length
+          description: Minimum length of the input
         max_length:
           type: integer
-          description: Maximum length
+          description: Maximum length of the input
         is_required:
           type: boolean
-          description: Required
+          description: Logical value whether the field is required
         is_for_all:
           type: boolean
-          description: For all projects
+          description: Logical value whether the field will be available for all projects
         is_filter:
           type: boolean
-          description: Used as a filter
+          description: Logical value whether the field can be used for filtering
         position:
           type: integer
           example: 2
-          description: Position of custom field in list
+          description: Position of custom field in the list
         searchable:
           type: boolean
-          description: is searchable ?
+          description: Logical value whether the field can be used for search
         default_value:
           type: string
-          description: Default value
+          description: Default value of the field
         editable:
           type: boolean
-          description: Editable
+          description: Logical value whether the field is editable
         visible:
           type: boolean
-          description: Visible
+          description: Logical value whether the field is visible
         multiple:
           type: boolean
-          description: Multiple values
+          description: Logical value whether the field can have multiple values
         description:
           type: string
-          description: Description
+          description: Description of the custom filed shown to the users
         is_primary:
           type: boolean
-          description: Primary
+          description: Logical value whether the field is primary
         show_empty:
           type: boolean
           description: Show with empty fields
@@ -12593,10 +12596,10 @@ components:
           description: Its Hash object
         internal_name:
           type: string
-          description: ''
+          description: Internal name of the field
         show_on_more_form:
           type: boolean
-          example: 'true'
+          example: true
           description: Show as additional attribute
         easy_external_id:
           type: string
@@ -12611,14 +12614,14 @@ components:
           description: ''
         mail_notification:
           type: boolean
-          example: 'true'
+          example: true
           description: Email notifications
         easy_group_id:
           type: integer
           description: ''
         clear_when_anonymize:
           type: boolean
-          description: Clear when anonymize
+          description: Whether to clear the field when data is anonymized
         possible_values:
           type: array
           xml: