> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blueplant.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Pflanzenbehälter anlegen

> Legt einen Pflanzenbehälter mit optionalen Größen an.



## OpenAPI

````yaml api/openapi.json POST /product/plant/container
openapi: 3.1.0
info:
  title: blueplant API
  version: v1
  description: >-
    Öffentliche REST-API von blueplant zum Anlegen von Stammdaten (Kunden,
    Standorte, Kontaktpersonen, Pflanzen, Behälter und Produkte) aus anderen
    Systemen. Authentifiziert wird mit deinem API-Schlüssel aus den
    Mandanten-Einstellungen.
servers:
  - url: https://api.blueplant.app/api/v1
    description: Produktiv
security:
  - ApiKey: []
paths:
  /product/plant/container:
    post:
      tags:
        - Pflanzen & Produkte
      summary: Pflanzenbehälter anlegen
      description: >-
        Legt einen Pflanzenbehälter (z. B. Topf oder Kübel) mit optionalen
        Größen an.
      operationId: createPlantContainer
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - name
              properties:
                name:
                  type: string
                  description: Name des Behälters.
                sizes:
                  type: array
                  description: Verfügbare Größen des Behälters.
                  items:
                    $ref: '#/components/schemas/Size'
                validFrom:
                  type: string
                  format: date
                  description: Beginn der Gültigkeit.
                validUntil:
                  type: string
                  format: date
                  description: Ende der Gültigkeit.
      responses:
        '201':
          description: >-
            Behälter angelegt. Die Antwort enthält die ID des Behälters sowie
            die IDs der angelegten Größen.
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    format: uuid
                    description: ID des angelegten Behälters.
                  sizes:
                    type: array
                    description: Angelegte Größen mit ihren IDs.
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                        name:
                          type: string
        '400':
          $ref: '#/components/responses/ValidationError'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '429':
          $ref: '#/components/responses/TooManyRequests'
components:
  schemas:
    Size:
      type: object
      description: Größe eines Pflanzenbehälters (Maße in cm).
      required:
        - name
      properties:
        name:
          type: string
          description: Bezeichnung der Größe.
        height:
          type: number
          description: Höhe in cm.
        width:
          type: number
          description: Breite in cm.
        length:
          type: number
          description: Länge in cm.
        diameter:
          type: number
          description: Durchmesser in cm.
    ValidationError:
      type: object
      description: Validierungsfehler mit feldbezogenen Meldungen.
      properties:
        message:
          type: string
          example: invalid input
        errors:
          type: array
          description: Liste der fehlerhaften Felder mit Meldungen.
          items:
            type: object
  responses:
    ValidationError:
      description: Ungültiges Request-Payload (Validierungsfehler).
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ValidationError'
    Unauthorized:
      description: Authentifizierung fehlgeschlagen – prüfe deinen API-Schlüssel.
    TooManyRequests:
      description: Zu viele Anfragen – versuche es später erneut.
  securitySchemes:
    ApiKey:
      type: apiKey
      in: header
      name: ApiKey
      description: >-
        Dein API-Schlüssel aus den Mandanten-Einstellungen, gesendet im Header
        `ApiKey`.

````