> ## Documentation Index > Fetch the complete documentation index at: https://docs.vellaro.io/llms.txt > Use this file to discover all available pages before exploring further. # Put Settings (/extra-warranty/settings) > Salvataggio PARZIALE: un campo assente (o `null`) resta com'è; `names`, `descriptions`, `excluded_category_ids` e `pilot_emails` si mandano interi. - 409 `extra_warranty.not_allowed` senza il permesso dell'hub; - 422 `extra_warranty.settings_invalid`, `data.fields = [{field, type}]`; `type`: `extra_warranty.percent_invalid`, `.percent_out_of_range` (oltre 0, al più 50), `.percent_too_precise` (al più due decimali), `.min_price_invalid`, `.min_price_out_of_range`, `.min_price_too_precise`, `.years_invalid`, `.years_out_of_range` (1-10), `.rounding_invalid` (1, 10 o 100), `.name_too_long` (60), `.description_too_long` (200), `.locale_unknown` (una lingua che il negozio non ha attiva), `.name_required` (`field` = `names.`), `.terms_path_invalid`, `.category_unknown`, `.categories_too_many` (200), `.email_invalid` (`field` = `pilot_emails.`), `.pilot_emails_too_many` (20), `.field_read_only` (`version`), `extra_forbidden` (campo sconosciuto, anche `iute_allowed`), o il tipo Pydantic. Un cambio alza `config.version`. Audit `extra_warranty.settings` con `before`/`after` delle sole voci cambiate, senza le email dei piloti (`pilot_emails_count`); nessun cambio, nessuna riga. ## OpenAPI ````yaml https://api.vellaro.io/openapi/admin.json put /api/v1/admin/extra-warranty/settings openapi: 3.1.0 info: title: Vellaro Admin API description: >- Store management under `/api/v1/admin`, for back ends and integrations. Every call takes `Authorization: Bearer `: an admin API token or a staff user's token. The permissions of its role decide what it can do, always in its own store. version: 0.1.0 servers: - url: https://api.vellaro.io description: Produzione security: [] tags: - name: Orders description: >- Orders and manual orders, payments, refunds, shipments, invoices, returns, customer subscriptions. - name: Products description: Products, variants, images, prices and discounts, product lookups. - name: Categories & catalog setup description: >- Categories, brands, attributes, options, filters, downloadable files, recurring profiles. - name: Inventory description: Stock of the variants and stock statuses. - name: Customers description: Customers, customer groups, custom fields. - name: Reviews & questions description: Moderation of product reviews and questions. - name: Promotions & coupons description: Coupons and gift vouchers. - name: Marketing description: Campaigns, newsletter subscribers, affiliates and their commissions. - name: Content description: >- CMS pages, menus, banners, information pages, flipbooks, media library, SEO URLs, email templates, translations. - name: Settings description: >- Store settings, email delivery, languages, currencies, physical stores, social login providers. - name: Shipping description: Couriers, shipping rates, weight and length classes. - name: Taxes & geo description: Tax classes, rates and rules; countries, zones and geo zones. - name: Integrations & modules description: >- Integrations, plugins and modules (Iute, extra warranty, Nextera, Financa 5, WhatsApp, Firebase), outbound webhooks. - name: AI description: AI content generation and the settings of the AI shopping assistant. - name: Imports description: 'CSV imports and the universal import: runs, mappings, previews, undo.' - name: Reports & dashboard description: Dashboard figures and reports. - name: Users & API keys description: Staff users and roles, publishable keys, admin API tokens. - name: Audit description: The store's audit log. paths: /api/v1/admin/extra-warranty/settings: put: tags: - Integrations & modules summary: Put Settings (/extra-warranty/settings) description: >- Salvataggio PARZIALE: un campo assente (o `null`) resta com'è; `names`, `descriptions`, `excluded_category_ids` e `pilot_emails` si mandano interi. - 409 `extra_warranty.not_allowed` senza il permesso dell'hub; - 422 `extra_warranty.settings_invalid`, `data.fields = [{field, type}]`; `type`: `extra_warranty.percent_invalid`, `.percent_out_of_range` (oltre 0, al più 50), `.percent_too_precise` (al più due decimali), `.min_price_invalid`, `.min_price_out_of_range`, `.min_price_too_precise`, `.years_invalid`, `.years_out_of_range` (1-10), `.rounding_invalid` (1, 10 o 100), `.name_too_long` (60), `.description_too_long` (200), `.locale_unknown` (una lingua che il negozio non ha attiva), `.name_required` (`field` = `names.`), `.terms_path_invalid`, `.category_unknown`, `.categories_too_many` (200), `.email_invalid` (`field` = `pilot_emails.`), `.pilot_emails_too_many` (20), `.field_read_only` (`version`), `extra_forbidden` (campo sconosciuto, anche `iute_allowed`), o il tipo Pydantic. Un cambio alza `config.version`. Audit `extra_warranty.settings` con `before`/`after` delle sole voci cambiate, senza le email dei piloti (`pilot_emails_count`); nessun cambio, nessuna riga. operationId: put_settings_api_v1_admin_extra_warranty_settings_put requestBody: content: application/json: schema: title: Body required: true responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/ApiResponse_ExtraWarrantySettingsOut_' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - HTTPBearer: [] components: schemas: ApiResponse_ExtraWarrantySettingsOut_: properties: data: anyOf: - $ref: '#/components/schemas/ExtraWarrantySettingsOut' - type: 'null' meta: anyOf: - $ref: '#/components/schemas/PaginationMeta' - type: 'null' error: anyOf: - type: string - type: 'null' title: Error error_code: anyOf: - type: string - type: 'null' title: Error Code type: object title: ApiResponse[ExtraWarrantySettingsOut] HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ExtraWarrantySettingsOut: properties: installed: type: boolean title: Installed enabled: type: boolean title: Enabled plugin_status: anyOf: - type: string - type: 'null' title: Plugin Status enabled_at: anyOf: - type: string format: date-time - type: 'null' title: Enabled At state: type: string enum: - 'off' - pilot - 'on' title: State allowed: type: boolean title: Allowed config: $ref: '#/components/schemas/ExtraWarrantyConfigView' languages: items: type: string type: array title: Languages base_locale: type: string title: Base Locale warnings: items: type: string type: array title: Warnings type: object required: - installed - enabled - plugin_status - enabled_at - state - allowed - config - languages - base_locale - warnings title: ExtraWarrantySettingsOut description: GET/PUT /admin/extra-warranty/settings e POST /enable, /disable. PaginationMeta: properties: page: type: integer title: Page page_size: type: integer title: Page Size total: type: integer title: Total total_pages: type: integer title: Total Pages type: object required: - page - page_size - total - total_pages title: PaginationMeta ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError ExtraWarrantyConfigView: properties: pilot_only: type: boolean title: Pilot Only percent: type: string pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ title: Percent min_price: type: string pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ title: Min Price years: type: integer title: Years rounding: type: integer title: Rounding names: additionalProperties: type: string type: object title: Names descriptions: additionalProperties: type: string type: object title: Descriptions terms_path: type: string title: Terms Path excluded_category_ids: items: type: string format: uuid type: array title: Excluded Category Ids pilot_emails: items: type: string type: array title: Pilot Emails version: type: integer title: Version type: object required: - pilot_only - percent - min_price - years - rounding - names - descriptions - terms_path - excluded_category_ids - pilot_emails - version title: ExtraWarrantyConfigView description: >- La config come la vede l'admin: le lingue sono quelle attive del negozio più la sua lingua base (il nome nella lingua base c'è sempre), le categorie solo quelle che esistono ancora. Gli importi escono come testo (`"10"`, `"20000"`). securitySchemes: HTTPBearer: type: http scheme: bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.