> ## Documentation Index
> Fetch the complete documentation index at: https://help.polygon-one.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Parzelle verknüpfen

> Replace the supplier articles a plot is linked to. Requires `plots:write`. This is the only change this endpoint makes — other plot fields cannot be edited over the API. The list replaces the current links; links not in it are removed. The compliance status of every affected supplier article is recalculated.

An id that names no plot of your company (unknown, deleted, or another company's) answers `404`. A supplier-article id that does not belong to your company answers `403`. A malformed plot id or a body that is not valid JSON answers `400`. Nothing is changed in any of these cases.



## OpenAPI

````yaml PATCH /api/plots/{id}
openapi: 3.1.0
info:
  title: Polygon One Compliance API
  description: >-
    API for integrating ERP systems with the Polygon One EUDR Compliance
    Platform. Allows management of Articles, Suppliers, Orders, and Due
    Diligence Statements (DDS). PPWR packaging master data, the SKU quantity
    feed and Mengenmeldung reports are covered by the PPWR groups.
  version: 1.0.0
servers:
  - url: https://app.polygon-one.com
    description: Production Server
security:
  - bearerAuth: []
paths:
  /api/plots/{id}:
    patch:
      summary: Update Plot Links
      description: >-
        Replace the supplier articles a plot is linked to. Requires
        `plots:write`. This is the only change this endpoint makes — other plot
        fields cannot be edited over the API. The list replaces the current
        links; links not in it are removed. The compliance status of every
        affected supplier article is recalculated.


        An id that names no plot of your company (unknown, deleted, or another
        company's) answers `404`. A supplier-article id that does not belong to
        your company answers `403`. A malformed plot id or a body that is not
        valid JSON answers `400`. Nothing is changed in any of these cases.
      operationId: updatePlot
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            format: uuid
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdatePlotInput'
      responses:
        '200':
          description: Links replaced
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalError'
components:
  schemas:
    UpdatePlotInput:
      type: object
      required:
        - supplierArticleIds
      properties:
        supplierArticleIds:
          type: array
          minItems: 1
          maxItems: 5000
          items:
            type: string
            format: uuid
          description: >-
            The complete new set of supplier articles for this plot. It
            **replaces** the current links: links not in the list are removed.
            At least one id.
    ErrorResponse:
      type: object
      properties:
        error:
          type: string
        details:
          description: Additional error details (e.g. validation issues)
      required:
        - error
  responses:
    BadRequest:
      description: Invalid request data
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    Unauthorized:
      description: Invalid or missing API key
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    Forbidden:
      description: Insufficient permissions for this resource
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    NotFound:
      description: Resource not found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    InternalError:
      description: Internal server error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: >-
        API key generated in Settings > API Keys. Include as `Authorization:
        Bearer <key>`.

````