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

# API-Einführung

> KI-Funktionen und deine Wissensdatenbank von nuwacom in eigene Anwendungen integrieren

## Überblick

Die nuwacom API bietet programmatischen Zugriff auf deinen Workspace: KI-Completions mit führenden Modellen ausführen, Agents verwalten und mit deiner Wissensdatenbank arbeiten. Ob du eigene Anwendungen baust, Workflows automatisierst oder bestehende Systeme erweiterst, die API liefert die passenden Bausteine.

## Verfügbare APIs

### Completion API

Führe KI-Completions über eine OpenAI-kompatible Schnittstelle aus. Nutze Modelle direkt, aktiviere die Suche in der Wissensdatenbank und im Web oder chatte mit einem konfigurierten Agent.

* [OpenAI Chat Completion](/api-reference/completion-api/openai-chat-completion): OpenAI-kompatible Chat-Completions, inklusive Agent-Unterstützung über die Option `agentId`

### Agents API

Erstelle und verwalte Agents programmatisch, mit eigenen Instruktionen, Gesprächseinstiegen und Modell-Optionen.

* [Agents-API Übersicht](/de/admin/agents-api-uebersicht): Kompletter Leitfaden zur Arbeit mit Agents
* [Auflisten](/api-reference/agents/list-agents), [Erstellen](/api-reference/agents/create-an-agent), [Abrufen](/api-reference/agents/get-an-agent), [Aktualisieren](/api-reference/agents/update-an-agent), [Löschen](/api-reference/agents/delete-an-agent)

### Assets API

Verwalte Dokumente in deiner Wissensdatenbank für Retrieval-Augmented Generation.

* [Asset per URL hinzufügen](/api-reference/assets/add-an-asset-via-url)
* [Asset hochladen](/api-reference/assets/upload-an-asset)
* [Abrufen](/api-reference/assets/get-an-asset), [Aktualisieren](/api-reference/assets/update-an-asset), [Löschen](/api-reference/assets/delete-an-asset)

### KI-Modelle

Finde heraus, welche Modelle in deinem Workspace und deinen Spaces verfügbar sind. Diese Modell-IDs verwendest du in Completion-Requests und Agent-Optionen.

* [Alle KI-Modelle auflisten](/api-reference/ai/list-all-ai-models)
* [KI-Modelle eines Space auflisten](/api-reference/ai/list-space-ai-models)

## Erste Schritte

### Base URL

Jede nuwacom-Instanz läuft auf einer eigenen Tenant-Domain. Verwende den Tenant-Namen deines Workspace für alle API-Requests:

```
https://{customer-tenant}.nuwacom.ai
```

### Authentifizierung

Alle API-Requests erfordern eine Authentifizierung per Bearer-Token:

```bash theme={null}
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://{customer-tenant}.nuwacom.ai/api/ai/models"
```

Admins können API-Keys in den Workspace-Einstellungen im Bereich **API Keys** erstellen und verwalten. Wenn du kein Admin bist, wende dich an deinen nuwacom-Admin, um einen API-Key anzufordern.

<Info>
  Bewahre deinen API-Key in einer sicheren Backend-Umgebung auf. Verwende ihn niemals in clientseitigem Code, etwa in JavaScript im Browser.
</Info>

### Spaces

Die meisten Ressourcen (Agents, Assets, Unterhaltungen) gehören zu einem **Space**. Die entsprechenden Requests erwarten die Space-ID, entweder im URL-Pfad (z. B. `/api/v1/spaces/{spaceId}/agents`) oder als `space_id`-Parameter, und die Rolle des Aufrufers im Space bestimmt, was erlaubt ist.

## OpenAPI-Spezifikation

Eine vollständige OpenAPI-Spezifikation für deine Instanz findest du unter `https://{customer-tenant}.nuwacom.ai/api/openapi.json`

Wir bieten zwei benutzerfreundliche Oberflächen, um die OpenAPI-Dokumentation zu erkunden:

* Scalar: `https://{customer-tenant}.nuwacom.ai/api/scalar`
* Swagger UI: `https://{customer-tenant}.nuwacom.ai/api/swagger`

## **Completion API**

Die grundlegende API ist die Completion API. Damit können Sie KI-Modelle in anderen Tools oder in Ihren eigenen Workflows verwenden. Die Completion API nutzt das Standardmodell. Weitere Informationen finden Sie im Abschnitt [Completion Endpoint](/api-reference/completion-api/openai-chat-completion).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.