# Endpunkte

Eine API besteht zumeist aus mehreren Endpunkten. Die Endpunkte haben meist unterschiedliche Aufgaben wie das Lesen, Schreiben, Aktualisieren oder Löschen von Resourcen.

Um einen neuen Endpunkt zu erstellen, klicken Sie auf das <img src="/files/32GhkrdYgbHLeEkg44Lg" alt="" data-size="line"> Symbol am Ender der Liste.

Um einen Endpunkt zu bearbeiten, klicken Sie in der Liste darauf.

<figure><img src="/files/P5UBCRNmBPfk4fD0NGnq" alt="" width="563"><figcaption></figcaption></figure>

## Konfiguration

<figure><img src="/files/xD8xwH2VPa0pFZRmGsGX" alt="" width="563"><figcaption></figcaption></figure>

Jeder Endpunkt benötigt einen eindeutigen *Namen*, um ihn später in Workflows einfacher zu identifizieren. Für die *Request-Methode* stehen die Werte *`GET`*, *`POST`*, *`PUT`*, *`PATCH`* und *`DELETE`* zur Verfügung.

Der *Pfad* gibt an, wohin der Request am Server gesendet werden soll. Die vollständige URL des Endpunkts setzt sich aus dem Host der API-Spezifikation und dem hier angegebenen Pfad zusammen.

Mit dem Button *Testen* können Sie den Endpunkt aufrufen und überprüfen, ob er wie gewünscht funktioniert.

Spezielle Request-Header für diesen Endpunkt können ebenfalls hier definiert werden. Wenn Header auf Endpunkt- und API-Ebene den gleichen Namen haben, überschreiben die Endpunkt-Header die globalen API-Header.

Im mehrzeiligen Eingabefeld *Inhalt* kann der Request-Body definiert werden. Die Seite [JSON als Request-Body](/robot/api-spezifikationen/json-als-request-body.md) beschreibt, wie JSON und Platzhalter zusammen mit Variablen verwendet werden können.

## Protokoll

Der Reiter *Protokoll* zeigt Ihnen wie oft dieser Endpunkt verwendet wurde. Neben dem Datum und der Ausführungszeit wird auch der Response-Code des Aufrufs angezeigt. Beim Klick auf einen Eintrag dieser Liste, werden Details angezeigt.

<figure><img src="/files/Kh0sqEUm5Mv7rBzZfS9U" alt="" width="563"><figcaption></figcaption></figure>

Im oberen Bereich des Protokolls sehen Sie das Ausführungsdatum und die Dauer des Aufrufs. Links ermöglichen den direkten Sprung zum Workflow-Protokoll, in dem dieser Aufruf stattgefunden hat. Die Navigation zum vorherigen bzw. nächsten Protokoll ist ebenfalls möglich.

Zusätzlich werden die Request-Methode, der Response-Code und die URL des Endpunkts angezeigt.

<figure><img src="/files/xrkmPtocBsT42agA74CY" alt=""><figcaption></figcaption></figure>

Der untere Bereich zeigt Request- und Response-Body sowie die dazugehörigen Header. Der Body kann entweder formatiert oder in seiner Originalform angezeigt werden, also genau so, wie er an den Server gesendet oder vom Server empfangen wurde.

<figure><img src="/files/JlDsUO2xTQzuI7XTXJaS" alt="" width="563"><figcaption></figcaption></figure>

Beim Klick auf *Header* werden Request- und Responser-Header angezeigt.

<figure><img src="/files/TU9kVoe32ymXexzRpXfd" alt="" width="563"><figcaption></figcaption></figure>

## Verwendung

Der letzte Reiter *Verwendung* zeigt Ihnen, in welchen Workflows dieser Endpunkt in Verwendung ist.

<figure><img src="/files/wkeeiEv6BLLq37RuoV3v" alt="" width="563"><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.aiaibot.com/robot/api-spezifikationen/endpunkte.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
