> ## Documentation Index > Fetch the complete documentation index at: https://docs.chataigne.ai/llms.txt > Use this file to discover all available pages before exploring further. # Créer une formule ## OpenAPI ````yaml /fr/api-reference/catalogs-v1.json post /v1/locations/{location_id}/catalogs/{catalog_id}/bundles openapi: 3.0.0 info: title: API Catalogues Chataigne description: >- Synchronisez des catalogues complets ou modifiez des ressources individuellement. version: '2026-05-01' contact: {} servers: - url: https://server.chataigne.ai security: [] tags: [] paths: /v1/locations/{location_id}/catalogs/{catalog_id}/bundles: post: tags: - Formules du catalogue summary: Créer une formule operationId: CatalogBundlesV1Controller_create parameters: - name: location_id in: path required: true schema: type: string example: loc_r8v4n2c6tz - name: catalog_id in: path required: true schema: type: string example: delivery-menu - name: Idempotency-Key in: header required: true schema: type: string description: >- Clé unique qui permet de relancer cette création sans risque ; les rejeux retournent la réponse initiale. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreateCatalogBundleRequest' responses: '201': description: La formule créée. content: application/json: schema: $ref: '#/components/schemas/CatalogBundle' '400': description: Requête invalide. content: application/json: schema: $ref: '#/components/schemas/Error' '401': description: Authentification requise. content: application/json: schema: $ref: '#/components/schemas/Error' '403': description: >- L’identité authentifiée n’est pas autorisée à effectuer cette requête. content: application/json: schema: $ref: '#/components/schemas/Error' '404': description: La ressource n’existe pas. content: application/json: schema: $ref: '#/components/schemas/Error' '409': description: Conflit de ressource ou d’idempotence. content: application/json: schema: $ref: '#/components/schemas/Error' security: - organization-api-key: [] components: schemas: CreateCatalogBundleRequest: $ref: '#/components/schemas/CatalogBundleInput' CatalogBundle: type: object additionalProperties: false required: - id - name - category_id - price - lines - object - disabled - out_of_stock - restrictions - price_overrides - created_at - updated_at properties: id: type: string example: classic-meal name: type: string example: Classic Meal category_id: type: string example: meals description: type: string nullable: true image_url: type: string format: uri nullable: true price: $ref: '#/components/schemas/CatalogPrice' disabled: type: boolean default: false description: Indique si la ressource est masquée et ne peut pas être commandée. out_of_stock: type: boolean default: false description: >- Indique si la ressource est temporairement indisponible tout en restant visible. restrictions: type: array maxItems: 100 default: [] description: >- Fenêtres de disponibilité. La ressource est disponible dès qu’une restriction correspond. items: $ref: '#/components/schemas/CatalogRestriction' price_overrides: type: array maxItems: 100 default: [] description: >- Prix conditionnels. Le prix correspondant aux conditions les plus spécifiques l’emporte. items: $ref: '#/components/schemas/CatalogPriceOverride' lines: type: array minItems: 1 items: $ref: '#/components/schemas/CatalogBundleLineInput' object: type: string enum: - bundle created_at: type: string format: date-time updated_at: type: string format: date-time Error: type: object properties: error: type: object required: - type - code - message - request_id properties: type: type: string enum: - invalid_request_error - authentication_error - authorization_error - not_found_error - conflict_error - rate_limit_error - idempotency_error - api_error code: type: string example: resource_missing message: type: string param: type: string request_id: type: string example: req_8f2c… details: type: object additionalProperties: true CatalogBundleInput: type: object required: - id - name - category_id - price - lines additionalProperties: false properties: id: type: string example: classic-meal name: type: string example: Classic Meal category_id: type: string example: meals description: type: string nullable: true image_url: type: string format: uri nullable: true price: $ref: '#/components/schemas/CatalogPrice' disabled: type: boolean default: false description: Indique si la ressource est masquée et ne peut pas être commandée. out_of_stock: type: boolean default: false description: >- Indique si la ressource est temporairement indisponible tout en restant visible. restrictions: type: array maxItems: 100 default: [] description: >- Fenêtres de disponibilité. La ressource est disponible dès qu’une restriction correspond. items: $ref: '#/components/schemas/CatalogRestriction' price_overrides: type: array maxItems: 100 default: [] description: >- Prix conditionnels. Le prix correspondant aux conditions les plus spécifiques l’emporte. items: $ref: '#/components/schemas/CatalogPriceOverride' lines: type: array minItems: 1 items: $ref: '#/components/schemas/CatalogBundleLineInput' CatalogPrice: type: object required: - amount - currency properties: amount: type: number minimum: 0 multipleOf: 0.01 example: 12.9 currency: type: string pattern: ^[A-Z]{3}$ example: EUR CatalogRestriction: type: object additionalProperties: false properties: days_of_week: type: array minItems: 1 uniqueItems: true default: - monday - tuesday - wednesday - thursday - friday - saturday - sunday items: type: string enum: - monday - tuesday - wednesday - thursday - friday - saturday - sunday start_time: type: string pattern: ^(?:[01]\d|2[0-3]):[0-5]\d$ nullable: true example: '18:00' end_time: type: string pattern: ^(?:[01]\d|2[0-3]):[0-5]\d$ nullable: true example: '22:00' start_date: type: string format: date-time nullable: true end_date: type: string format: date-time nullable: true service_types: type: array uniqueItems: true default: - delivery - collection items: type: string enum: - delivery - collection CatalogPriceOverride: type: object required: - price - conditions additionalProperties: false properties: price: $ref: '#/components/schemas/CatalogPrice' conditions: $ref: '#/components/schemas/CatalogPriceOverrideConditions' CatalogBundleLineInput: type: object required: - id - product_ids additionalProperties: false properties: id: type: string example: main name: type: string nullable: true min_selections: type: integer minimum: 0 default: 1 max_selections: type: integer minimum: 1 default: 1 product_ids: type: array minItems: 1 uniqueItems: true items: type: string CatalogPriceOverrideConditions: type: object minProperties: 1 additionalProperties: false properties: service_type: type: string enum: - delivery - collection nullable: true days_of_week: type: array minItems: 1 uniqueItems: true nullable: true items: type: string enum: - monday - tuesday - wednesday - thursday - friday - saturday - sunday start_time: type: string pattern: ^(?:[01]\d|2[0-3]):[0-5]\d$ nullable: true example: '18:00' end_time: type: string pattern: ^(?:[01]\d|2[0-3]):[0-5]\d$ nullable: true example: '22:00' securitySchemes: organization-api-key: type: apiKey in: header name: x-api-key description: Clé API d’établissement ou d’organisation. ````