> ## Documentation Index > Fetch the complete documentation index at: https://docs.pricenow.ch/llms.txt > Use this file to discover all available pages before exploring further. # Patch apicheckout items personalization > Personalize a checkout item. This is used to assign a person or medium to a checkout item. ## OpenAPI ````yaml https://pratiq-docs.s3.eu-west-1.amazonaws.com/open-api/production/public/2025-02-18.json patch /api/checkout/{checkoutId}/items/{itemId}/personalization openapi: 3.0.0 info: title: Pricenow API version: '2025-02-18' servers: - url: https://api.pricenow.dev description: Production Endpoint security: [] tags: [] paths: /api/checkout/{checkoutId}/items/{itemId}/personalization: patch: tags: - checkout description: >- Personalize a checkout item. This is used to assign a person or medium to a checkout item. parameters: - name: accept-language in: header description: Language of the response required: true schema: type: string enum: - en - de - fr - it - name: pratiq-channel-uuid in: header description: UUID of the sales channel required: true schema: type: string - name: checkoutId in: path required: true schema: type: string - name: itemId in: path required: true schema: type: number requestBody: content: application/json: schema: type: object properties: personId: type: number mediumType: oneOf: - type: object properties: {} - type: string enum: - SKIDATA - type: string enum: - AXESS - type: string enum: - SWISSPASS - type: string enum: - LICENSEPLATE - type: string enum: - FERATEL - type: string enum: - SKIDATA_RENEWAL - type: string enum: - SKIDATA_E_TICKET - type: string enum: - AXESS_RENEWAL - type: string enum: - ON_SITE - type: string enum: - CODE_DIRECT - type: string enum: - CODE_PICKUP - type: string enum: - DELIVERY keycardId: type: number responses: '200': description: Successful response content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/Checkout_PersonalizedCheckoutItem' required: - data components: schemas: Checkout_PersonalizedCheckoutItem: type: object properties: id: type: number parentItemId: type: number status: type: string enum: - RESERVED - PENDING - ISSUED - CANCELED productVariant: $ref: '#/components/schemas/Checkout_CheckoutProductVariant' validity: type: object properties: from: type: string to: type: string required: - from - to parentItem: $ref: '#/components/schemas/Checkout_CheckoutItem' childItems: type: array items: $ref: '#/components/schemas/Checkout_CheckoutItem' listPriceGross: type: number listPriceNet: type: number promoCodeDiscount: type: number autoDiscount: $ref: '#/components/schemas/Checkout_AutoDiscount' autoDiscountAmount: type: number totalDiscountGross: type: number totalDiscountNet: type: number totalGross: type: number totalNet: type: number vatRate: type: number displayPrice: type: boolean isDeletable: type: boolean requiresPersonalization: type: boolean requiresValidation: type: boolean requiresMedium: type: boolean isConfirmationRequired: type: boolean isFlexTicket: type: boolean isMaxOneTicketPerPerson: type: boolean isUniqueItem: type: boolean supportsWeatherGuarantee: type: boolean hasWeatherGuarantee: type: boolean personFieldsDefinition: type: object additionalProperties: oneOf: - type: object properties: label: type: object properties: en: type: string de: type: string fr: type: string it: type: string sortOrder: type: number type: type: string enum: - text required: type: object properties: owner: type: boolean person: type: boolean required: - owner - person enabled: type: object properties: owner: type: boolean person: type: boolean required: - owner - person placeholder: type: object properties: en: type: string de: type: string fr: type: string it: type: string nullable: true description: type: object properties: en: type: string de: type: string fr: type: string it: type: string nullable: true min: type: number nullable: true max: type: number nullable: true length: type: number nullable: true defaultValue: type: string nullable: true required: - label - sortOrder - type - required - enabled - type: object properties: label: type: object properties: en: type: string de: type: string fr: type: string it: type: string sortOrder: type: number type: type: string enum: - number required: type: object properties: owner: type: boolean person: type: boolean required: - owner - person enabled: type: object properties: owner: type: boolean person: type: boolean required: - owner - person placeholder: type: object properties: en: type: string de: type: string fr: type: string it: type: string nullable: true description: type: object properties: en: type: string de: type: string fr: type: string it: type: string nullable: true min: type: number nullable: true max: type: number nullable: true options: type: array items: type: number nullable: true defaultValue: type: number nullable: true required: - label - sortOrder - type - required - enabled - type: object properties: label: type: object properties: en: type: string de: type: string fr: type: string it: type: string sortOrder: type: number type: type: string enum: - select options: type: array items: type: object properties: label: type: object properties: en: type: string de: type: string fr: type: string it: type: string value: type: string required: - label - value required: type: object properties: owner: type: boolean person: type: boolean required: - owner - person enabled: type: object properties: owner: type: boolean person: type: boolean required: - owner - person placeholder: type: object properties: en: type: string de: type: string fr: type: string it: type: string nullable: true description: type: object properties: en: type: string de: type: string fr: type: string it: type: string nullable: true defaultValue: type: string nullable: true required: - label - sortOrder - type - options - required - enabled - type: object properties: label: type: object properties: en: type: string de: type: string fr: type: string it: type: string sortOrder: type: number type: type: string enum: - date required: type: object properties: owner: type: boolean person: type: boolean required: - owner - person enabled: type: object properties: owner: type: boolean person: type: boolean required: - owner - person placeholder: type: object properties: en: type: string de: type: string fr: type: string it: type: string nullable: true description: type: object properties: en: type: string de: type: string fr: type: string it: type: string nullable: true min: type: string nullable: true max: type: string nullable: true defaultValue: type: string nullable: true required: - label - sortOrder - type - required - enabled - type: object properties: label: type: object properties: en: type: string de: type: string fr: type: string it: type: string sortOrder: type: number type: type: string enum: - tel required: type: object properties: owner: type: boolean person: type: boolean required: - owner - person enabled: type: object properties: owner: type: boolean person: type: boolean required: - owner - person placeholder: type: object properties: en: type: string de: type: string fr: type: string it: type: string nullable: true description: type: object properties: en: type: string de: type: string fr: type: string it: type: string nullable: true defaultValue: type: string nullable: true required: - label - sortOrder - type - required - enabled - type: object properties: label: type: object properties: en: type: string de: type: string fr: type: string it: type: string sortOrder: type: number type: type: string enum: - file fileType: type: string enum: - avatar - document - image acceptedMimeTypes: type: array items: type: string required: type: object properties: owner: type: boolean person: type: boolean required: - owner - person enabled: type: object properties: owner: type: boolean person: type: boolean required: - owner - person placeholder: type: object properties: en: type: string de: type: string fr: type: string it: type: string nullable: true description: type: object properties: en: type: string de: type: string fr: type: string it: type: string nullable: true defaultValue: type: string nullable: true required: - label - sortOrder - type - fileType - acceptedMimeTypes - required - enabled - type: object properties: label: type: object properties: en: type: string de: type: string fr: type: string it: type: string sortOrder: type: number type: type: string enum: - checkbox required: type: object properties: owner: type: boolean person: type: boolean required: - owner - person enabled: type: object properties: owner: type: boolean person: type: boolean required: - owner - person placeholder: type: object properties: en: type: string de: type: string fr: type: string it: type: string nullable: true description: type: object properties: en: type: string de: type: string fr: type: string it: type: string nullable: true defaultValue: oneOf: - type: object properties: {} - nullable: true - type: boolean - type: boolean nullable: true required: - label - sortOrder - type - required - enabled person: $ref: '#/components/schemas/Checkout_Person' medium: oneOf: - nullable: true - type: object properties: description: type: string name: type: string type: type: string enum: - SKIDATA - AXESS - SWISSPASS - LICENSEPLATE - FERATEL - SKIDATA_RENEWAL - SKIDATA_E_TICKET - AXESS_RENEWAL - ON_SITE - CODE_DIRECT - CODE_PICKUP - DELIVERY id: type: number priceComponents: type: array items: type: object properties: price: type: number productVariant: type: object properties: id: type: number name: type: string translation: type: string vatRate: type: number productId: type: number attributes: type: array items: $ref: '#/components/schemas/Catalog_Attribute' required: - id - name - translation - vatRate - productId - attributes intent: type: string enum: - SENDING_FEE - DEPOT required: - price - productVariant - intent requiresKeycard: type: boolean keycard: $ref: '#/components/schemas/Checkout_Keycard' required: - description - name - type - id - priceComponents - requiresKeycard - keycard - type: object properties: description: type: string name: type: string type: type: string enum: - SKIDATA - AXESS - SWISSPASS - LICENSEPLATE - FERATEL - SKIDATA_RENEWAL - SKIDATA_E_TICKET - AXESS_RENEWAL - ON_SITE - CODE_DIRECT - CODE_PICKUP - DELIVERY id: type: number priceComponents: type: array items: type: object properties: price: type: number productVariant: type: object properties: id: type: number name: type: string translation: type: string vatRate: type: number productId: type: number attributes: type: array items: $ref: '#/components/schemas/Catalog_Attribute' required: - id - name - translation - vatRate - productId - attributes intent: type: string enum: - SENDING_FEE - DEPOT required: - price - productVariant - intent requiresKeycard: type: boolean keycard: nullable: true required: - description - name - type - id - priceComponents - requiresKeycard - keycard compatiblePersons: type: array items: $ref: '#/components/schemas/Checkout_Person' incompatiblePersons: type: array items: type: object properties: reasons: type: array items: oneOf: - type: object properties: type: type: string enum: - MISSING_REQUIRED_PERSONAL_DATA metaData: type: object properties: missingFields: type: array items: type: string required: - missingFields required: - type - metaData - type: object properties: type: type: string enum: - PERSON_ALREADY_ASSIGNED metaData: nullable: true required: - type - metaData - type: object properties: type: type: string enum: - PERSON_AGE_INCOMPATIBLE metaData: oneOf: - type: object properties: type: type: string enum: - AGE age: type: number minAge: type: number nullable: true maxAge: type: number nullable: true required: - type - age - minAge - maxAge - type: object properties: type: type: string enum: - BIRTHYEAR year: type: number minYear: type: number nullable: true maxYear: type: number nullable: true required: - type - year - minYear - maxYear required: - type - metaData - type: object properties: type: type: string enum: - PERSON_TARIF_INCOMPATIBLE metaData: type: object properties: incompatibleKeycards: type: array items: $ref: '#/components/schemas/Checkout_Keycard' requiredKeycardType: oneOf: - nullable: true - type: string enum: - SKIDATA - type: string enum: - AXESS - type: string enum: - SWISSPASS - type: string enum: - SWISSTRAVELPASS - type: string enum: - LICENSEPLATE - type: string enum: - FERATEL - type: string enum: - EUINTERRAIL nullable: true required: - incompatibleKeycards - requiredKeycardType required: - type - metaData person: $ref: '#/components/schemas/Checkout_Person' required: - reasons - person availableMedia: type: array items: oneOf: - type: object properties: description: type: string name: type: string type: type: string enum: - SKIDATA - AXESS - SWISSPASS - LICENSEPLATE - FERATEL - SKIDATA_RENEWAL - SKIDATA_E_TICKET - AXESS_RENEWAL - ON_SITE - CODE_DIRECT - CODE_PICKUP - DELIVERY id: type: number priceComponents: type: array items: type: object properties: price: type: number productVariant: type: object properties: id: type: number name: type: string translation: type: string vatRate: type: number productId: type: number attributes: type: array items: $ref: '#/components/schemas/Catalog_Attribute' required: - id - name - translation - vatRate - productId - attributes intent: type: string enum: - SENDING_FEE - DEPOT required: - price - productVariant - intent requiresKeycard: type: boolean compatibleKeycards: type: array items: $ref: '#/components/schemas/Checkout_Keycard' incompatibleKeycards: type: array items: type: object properties: reasons: type: array items: type: string enum: - INCOMPATIBLE_KEYCARD_TYPE keycard: $ref: '#/components/schemas/Checkout_Keycard' required: - reasons - keycard required: - description - name - type - id - priceComponents - requiresKeycard - compatibleKeycards - incompatibleKeycards - type: object properties: description: type: string name: type: string type: type: string enum: - SKIDATA - AXESS - SWISSPASS - LICENSEPLATE - FERATEL - SKIDATA_RENEWAL - SKIDATA_E_TICKET - AXESS_RENEWAL - ON_SITE - CODE_DIRECT - CODE_PICKUP - DELIVERY id: type: number priceComponents: type: array items: type: object properties: price: type: number productVariant: type: object properties: id: type: number name: type: string translation: type: string vatRate: type: number productId: type: number attributes: type: array items: $ref: '#/components/schemas/Catalog_Attribute' required: - id - name - translation - vatRate - productId - attributes intent: type: string enum: - SENDING_FEE - DEPOT required: - price - productVariant - intent requiresKeycard: type: boolean required: - description - name - type - id - priceComponents - requiresKeycard required: - id - parentItemId - status - productVariant - validity - parentItem - childItems - listPriceGross - listPriceNet - promoCodeDiscount - autoDiscount - autoDiscountAmount - totalDiscountGross - totalDiscountNet - totalGross - totalNet - vatRate - displayPrice - isDeletable - requiresPersonalization - requiresValidation - requiresMedium - isConfirmationRequired - isFlexTicket - isMaxOneTicketPerPerson - isUniqueItem - supportsWeatherGuarantee - hasWeatherGuarantee - personFieldsDefinition - person - medium - compatiblePersons - incompatiblePersons - availableMedia Checkout_CheckoutProductVariant: type: object properties: productId: type: number name: type: string id: type: number vatRate: type: number attributes: type: array items: $ref: '#/components/schemas/Catalog_Attribute' translation: type: string product: $ref: '#/components/schemas/Checkout_CheckoutProduct' availableMedia: type: array items: $ref: '#/components/schemas/Checkout_CheckoutMedium' required: - productId - name - id - vatRate - attributes - translation - product - availableMedia Checkout_CheckoutItem: type: object properties: id: type: number parentItemId: type: number nullable: true status: type: string enum: - RESERVED - PENDING - ISSUED - CANCELED productVariant: $ref: '#/components/schemas/Checkout_CheckoutProductVariant' validity: type: object properties: from: type: string to: type: string required: - from - to nullable: true parentItem: $ref: '#/components/schemas/Checkout_CheckoutItem' nullable: true childItems: type: array items: $ref: '#/components/schemas/Checkout_CheckoutItem' listPriceGross: type: number listPriceNet: type: number promoCodeDiscount: type: number autoDiscount: $ref: '#/components/schemas/Checkout_AutoDiscount' nullable: true autoDiscountAmount: type: number totalDiscountGross: type: number totalDiscountNet: type: number totalGross: type: number totalNet: type: number vatRate: type: number displayPrice: type: boolean isDeletable: type: boolean requiresPersonalization: type: boolean requiresValidation: type: boolean requiresMedium: type: boolean isConfirmationRequired: type: boolean isFlexTicket: type: boolean isMaxOneTicketPerPerson: type: boolean isUniqueItem: type: boolean supportsWeatherGuarantee: type: boolean hasWeatherGuarantee: type: boolean personFieldsDefinition: type: object additionalProperties: oneOf: - type: object properties: label: type: object properties: en: type: string de: type: string fr: type: string it: type: string sortOrder: type: number type: type: string enum: - text required: type: object properties: owner: type: boolean person: type: boolean required: - owner - person enabled: type: object properties: owner: type: boolean person: type: boolean required: - owner - person placeholder: type: object properties: en: type: string de: type: string fr: type: string it: type: string nullable: true description: type: object properties: en: type: string de: type: string fr: type: string it: type: string nullable: true min: type: number nullable: true max: type: number nullable: true length: type: number nullable: true defaultValue: type: string nullable: true required: - label - sortOrder - type - required - enabled - type: object properties: label: type: object properties: en: type: string de: type: string fr: type: string it: type: string sortOrder: type: number type: type: string enum: - number required: type: object properties: owner: type: boolean person: type: boolean required: - owner - person enabled: type: object properties: owner: type: boolean person: type: boolean required: - owner - person placeholder: type: object properties: en: type: string de: type: string fr: type: string it: type: string nullable: true description: type: object properties: en: type: string de: type: string fr: type: string it: type: string nullable: true min: type: number nullable: true max: type: number nullable: true options: type: array items: type: number nullable: true defaultValue: type: number nullable: true required: - label - sortOrder - type - required - enabled - type: object properties: label: type: object properties: en: type: string de: type: string fr: type: string it: type: string sortOrder: type: number type: type: string enum: - select options: type: array items: type: object properties: label: type: object properties: en: type: string de: type: string fr: type: string it: type: string value: type: string required: - label - value required: type: object properties: owner: type: boolean person: type: boolean required: - owner - person enabled: type: object properties: owner: type: boolean person: type: boolean required: - owner - person placeholder: type: object properties: en: type: string de: type: string fr: type: string it: type: string nullable: true description: type: object properties: en: type: string de: type: string fr: type: string it: type: string nullable: true defaultValue: type: string nullable: true required: - label - sortOrder - type - options - required - enabled - type: object properties: label: type: object properties: en: type: string de: type: string fr: type: string it: type: string sortOrder: type: number type: type: string enum: - date required: type: object properties: owner: type: boolean person: type: boolean required: - owner - person enabled: type: object properties: owner: type: boolean person: type: boolean required: - owner - person placeholder: type: object properties: en: type: string de: type: string fr: type: string it: type: string nullable: true description: type: object properties: en: type: string de: type: string fr: type: string it: type: string nullable: true min: type: string nullable: true max: type: string nullable: true defaultValue: type: string nullable: true required: - label - sortOrder - type - required - enabled - type: object properties: label: type: object properties: en: type: string de: type: string fr: type: string it: type: string sortOrder: type: number type: type: string enum: - tel required: type: object properties: owner: type: boolean person: type: boolean required: - owner - person enabled: type: object properties: owner: type: boolean person: type: boolean required: - owner - person placeholder: type: object properties: en: type: string de: type: string fr: type: string it: type: string nullable: true description: type: object properties: en: type: string de: type: string fr: type: string it: type: string nullable: true defaultValue: type: string nullable: true required: - label - sortOrder - type - required - enabled - type: object properties: label: type: object properties: en: type: string de: type: string fr: type: string it: type: string sortOrder: type: number type: type: string enum: - file fileType: type: string enum: - avatar - document - image acceptedMimeTypes: type: array items: type: string required: type: object properties: owner: type: boolean person: type: boolean required: - owner - person enabled: type: object properties: owner: type: boolean person: type: boolean required: - owner - person placeholder: type: object properties: en: type: string de: type: string fr: type: string it: type: string nullable: true description: type: object properties: en: type: string de: type: string fr: type: string it: type: string nullable: true defaultValue: type: string nullable: true required: - label - sortOrder - type - fileType - acceptedMimeTypes - required - enabled - type: object properties: label: type: object properties: en: type: string de: type: string fr: type: string it: type: string sortOrder: type: number type: type: string enum: - checkbox required: type: object properties: owner: type: boolean person: type: boolean required: - owner - person enabled: type: object properties: owner: type: boolean person: type: boolean required: - owner - person placeholder: type: object properties: en: type: string de: type: string fr: type: string it: type: string nullable: true description: type: object properties: en: type: string de: type: string fr: type: string it: type: string nullable: true defaultValue: oneOf: - type: object properties: {} - nullable: true - type: boolean - type: boolean nullable: true required: - label - sortOrder - type - required - enabled required: - id - parentItemId - status - productVariant - validity - parentItem - childItems - listPriceGross - listPriceNet - promoCodeDiscount - autoDiscount - autoDiscountAmount - totalDiscountGross - totalDiscountNet - totalGross - totalNet - vatRate - displayPrice - isDeletable - requiresPersonalization - requiresValidation - requiresMedium - isConfirmationRequired - isFlexTicket - isMaxOneTicketPerPerson - isUniqueItem - supportsWeatherGuarantee - hasWeatherGuarantee - personFieldsDefinition Checkout_AutoDiscount: type: object properties: id: type: number displayName: type: string description: type: string discountType: type: string enum: - ABSOLUTE - RELATIVE - FIXED_PRICE discount: type: number required: - id - displayName - description - discountType - discount Checkout_Person: type: object properties: id: type: number accountId: type: number formDefinition: type: object additionalProperties: oneOf: - type: object properties: required: type: boolean label: type: string sortOrder: type: number type: type: string enum: - text placeholder: type: string nullable: true description: type: string nullable: true autoComplete: type: string nullable: true min: type: number nullable: true max: type: number nullable: true length: type: number nullable: true required: - required - label - sortOrder - type - type: object properties: required: type: boolean label: type: string sortOrder: type: number type: type: string enum: - number placeholder: type: string nullable: true description: type: string nullable: true autoComplete: type: string nullable: true min: type: number nullable: true max: type: number nullable: true options: type: array items: type: number nullable: true required: - required - label - sortOrder - type - type: object properties: required: type: boolean label: type: string sortOrder: type: number type: type: string enum: - select options: type: array items: type: object properties: label: type: string value: type: string required: - label - value placeholder: type: string nullable: true description: type: string nullable: true autoComplete: type: string nullable: true required: - required - label - sortOrder - type - options - type: object properties: required: type: boolean label: type: string sortOrder: type: number type: type: string enum: - date placeholder: type: string nullable: true description: type: string nullable: true autoComplete: type: string nullable: true min: type: string nullable: true max: type: string nullable: true required: - required - label - sortOrder - type - type: object properties: required: type: boolean label: type: string sortOrder: type: number type: type: string enum: - tel placeholder: type: string nullable: true description: type: string nullable: true autoComplete: type: string nullable: true required: - required - label - sortOrder - type - type: object properties: required: type: boolean label: type: string sortOrder: type: number type: type: string enum: - file fileType: type: string enum: - avatar - document - image acceptedMimeTypes: type: array items: type: string placeholder: type: string nullable: true description: type: string nullable: true autoComplete: type: string nullable: true required: - required - label - sortOrder - type - fileType - acceptedMimeTypes - type: object properties: required: type: boolean label: type: string sortOrder: type: number type: type: string enum: - checkbox placeholder: type: string nullable: true description: type: string nullable: true autoComplete: type: string nullable: true required: - required - label - sortOrder - type - type: object properties: required: type: boolean label: type: string sortOrder: type: number type: type: string enum: - donation placeholder: type: string nullable: true description: type: string nullable: true autoComplete: type: string nullable: true required: - required - label - sortOrder - type - type: object properties: required: type: boolean label: type: string sortOrder: type: number type: type: string enum: - tip placeholder: type: string nullable: true description: type: string nullable: true autoComplete: type: string nullable: true required: - required - label - sortOrder - type defaultValues: type: object additionalProperties: type: object properties: {} values: type: object additionalProperties: type: object properties: {} isOwner: type: boolean required: - id - accountId - formDefinition - defaultValues - values - isOwner Catalog_Attribute: type: object properties: name: type: string identifier: type: string value: type: string sortOrder: type: number metaInformation: type: object additionalProperties: type: object properties: {} translation: type: string required: - name - identifier - value - sortOrder - metaInformation - translation Checkout_Keycard: type: object properties: id: type: number dataCarrierId: type: string personId: type: number metaInformation: type: object additionalProperties: type: object properties: {} nullable: true type: type: string enum: - SKIDATA - AXESS - SWISSPASS - SWISSTRAVELPASS - LICENSEPLATE - FERATEL - EUINTERRAIL required: - id - dataCarrierId - personId - metaInformation - type Checkout_CheckoutProduct: type: object properties: id: type: number sortOrder: type: number name: type: string translation: type: string identifier: type: string type: type: string enum: - TICKET - ARTICLE - BUNDLE - DYNAMIC_BUNDLE isSubscription: type: boolean standalone: type: boolean hasValidity: type: boolean imageUrl: type: string merchant: $ref: '#/components/schemas/Catalog_Merchant' category: $ref: '#/components/schemas/ProductCategory' slug: type: string required: - id - sortOrder - name - translation - identifier - type - isSubscription - standalone - hasValidity - imageUrl - merchant - category - slug Checkout_CheckoutMedium: type: object properties: description: type: string name: type: string type: type: string enum: - SKIDATA - AXESS - SWISSPASS - LICENSEPLATE - FERATEL - SKIDATA_RENEWAL - SKIDATA_E_TICKET - AXESS_RENEWAL - ON_SITE - CODE_DIRECT - CODE_PICKUP - DELIVERY id: type: number priceComponents: type: array items: type: object properties: price: type: number productVariant: type: object properties: id: type: number name: type: string translation: type: string vatRate: type: number productId: type: number attributes: type: array items: $ref: '#/components/schemas/Catalog_Attribute' required: - id - name - translation - vatRate - productId - attributes intent: type: string enum: - SENDING_FEE - DEPOT required: - price - productVariant - intent required: - description - name - type - id - priceComponents Catalog_Merchant: type: object properties: identifier: type: string timezone: type: string required: - identifier - timezone ProductCategory: type: object properties: id: type: number name: type: string required: - id - name ````