Deutsch English

Gruppe umbenennen oder verschieben

PATCH /api/v1/component-groups/:group

Beim Verschieben werden die Baum-Invarianten erneut geprüft: nicht in den eigenen Teilbaum und innerhalb der maximalen Verschachtelungstiefe.

Erforderliche Berechtigung

components.manage Komponenten verwalten

URL Variablen

Name Beschreibung
group

Body Parameter (application/json)

Name Format Beschreibung Optional
name string Locale-Objekt, z. B. {"de": "API-Gateway", "en": "API gateway"}. —
parent_id integer
position integer

Response (application/json) 

{1 Eigenschaft
  "data": {8 Eigenschaften
    "id": 1,
    "name": {2 Eigenschaften
      "de": "Rechenzentrum Frankfurt",
      "en": "Frankfurt data centre"
    },
    "slug": "rechenzentrum-frankfurt",
    "parent_id": null,
    "position": 0,
    "depth": 0,
    "created_at": "2026-05-04T08:00:00Z",
    "updated_at": "2026-05-04T08:00:00Z"
  }
}
{1 Eigenschaft
  "message": "Component group not found."
}
{2 Eigenschaften
  "message": "A group cannot be moved into itself or one of its own sub-groups.",
  "errors": {1 Eigenschaft
    "parent_id": [1 Element
      "A group cannot be moved into itself or one of its own sub-groups."
    ]
  }
}

cURL

curl -X PATCH 'https://status.example.com/api/v1/component-groups/:group' \
  -H 'Authorization: Bearer fs_YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"name":"VALUE","parent_id":"VALUE","position":"VALUE"}'