Skip to main content
Alle Endpunkte erfordern eine angemeldete Sitzung. Grundlagen siehe API-Überblick. Konzepte siehe Agents.

​
GET /api/agents

Alle Agents (offizielle und eigene) inklusive Speicher-Status für den aktuellen Nutzer abrufen. Query-Parameter:
ParameterTypPflichtBeschreibung
account_idUUIDJaAccount zum Filtern
Antwort: 
{
  "success": true,
  "agents": [
    {
      "id": "uuid",
      "name": "Marketing-Experte",
      "description": "Hilft bei Marketing-Inhalten",
      "icon_name": "SparklesIcon",
      "model": "gpt-4o",
      "system_prompt": "Du bist ein Marketing-Experte ...",
      "is_saved": true,
      "account_id": "uuid",
      "created_by": "uuid",
      "author_type": "team"
    }
  ]
}

​
POST /api/agents

Einen neuen eigenen Agent erstellen. Request-Body: 
{
  "account_id": "uuid",
  "name": "Marketing-Experte",
  "description": "Hilft bei Marketing-Inhalten",
  "icon_name": "SparklesIcon",
  "model": "managed:gpt-4o",
  "system_prompt": "Du bist ein Marketing-Experte ...",
  "greeting": "Hallo! Womit kann ich dir im Marketing helfen?",
  "author_type": "team",
  "remixed_from": "uuid"
}
Validierung:
  • account_id, name, description, icon_name, system_prompt, greeting: Pflicht
  • name: max. 100 Zeichen · description: max. 500 Zeichen
  • system_prompt: max. 5.000 Zeichen · greeting: max. 1.000 Zeichen
  • model: optional, leer = Account-Standardmodell; Managed-Modelle werden als Ref gespeichert
  • author_type: optional, "user" oder "team"; Standard ist "user"
  • temperature: optional, 0 bis 1; Standard ist 0.7
  • example_prompts: optional, maximal 12 Einträge mit je 200 Zeichen
  • enabled_tools: optional; erlaubt sind web_research, image_generation und code_execution
  • knowledge_enabled: optional; Standard ist true
  • skill_ids, knowledge_file_ids, knowledge_folder_ids: optional, UUID-Arrays
  • remixed_from: optional, nur beim Remix eines bestehenden Agents
Antwort: 
{
  "success": true,
  "agent": {
    "id": "uuid",
    "name": "Marketing-Experte",
    "description": "Hilft bei Marketing-Inhalten"
  }
}

​
GET /api/agents/[agentId]

Einen einzelnen Agent abrufen. Der Zugriff wird gegen die Berechtigungen geprüft.

​
PUT /api/agents/[agentId]

Einen eigenen Agent aktualisieren. Berechtigung: Eigentümer:in oder Bearbeiten-Recht. Offizielle Agents sind nicht änderbar. Request-Body (alle Felder optional): 
{
  "name": "Neuer Name",
  "description": "Neue Beschreibung",
  "icon_name": "BotIcon",
  "model": "gpt-4o-mini",
  "system_prompt": "Aktualisierter Prompt ...",
  "is_active": true,
  "author_type": "team"
}

​
DELETE /api/agents/[agentId]

Einen eigenen Agent löschen. Berechtigung: Ersteller:in oder Account-Owner. Offizielle Agents sind nicht löschbar. 
{
  "success": true,
  "message": "Agent deleted successfully"
}

​
Agents speichern

MethodeEndpunktBeschreibung
POST/api/agents/[agentId]/saveAgent als Favorit speichern
DELETE/api/agents/[agentId]/saveFavorit wieder entfernen
Der POST-Body enthält account_id; der DELETE-Endpunkt erwartet account_id als Query-Parameter. Beide Endpunkte antworten mit success: true; POST liefert bei einer neuen Speicherung zusätzlich savedAgent.