TeamDay.ai
← Docs

TeamDay API v1 - Übersicht

Die TeamDay API ermöglicht es Entwicklern, programmatisch mit der TeamDay KI-Plattform zu interagieren. Bauen Sie benutzerdefinierte Integrationen, automatisieren Sie Workflows und verwalten Sie KI-Agenten durch eine einfache REST API.

Basis-URL: https://us.teamday.ai/api/v1

Aktueller Status: 87,5% funktionsfähig (7 von 8 getesteten Endpunkten funktional)

Schnelleinstieg

# 1. Holen Sie sich Ihr API Token aus Einstellungen → API Zugriff
export TEAMDAY_TOKEN="td_your_token_here"

# 2. Machen Sie Ihre erste Anfrage
curl https://us.teamday.ai/api/v1/agents \
  -H "Authorization: Bearer $TEAMDAY_TOKEN"

API Gruppen

Die TeamDay v1 API ist in die folgenden Ressourcengruppen organisiert:

RessourceBeschreibungEndpunkte
AuthentifizierungPersonal Access Tokens (PAT)Token-Verwaltung
AgentenErstellen und verwalten Sie KI-Agenten6 Endpunkte
AusführungenVerfolgen Sie den Agent-Ausführungsverlauf4 Endpunkte
AufgabenVerwalten Sie Aufgaben und Workflows2 Endpunkte
FehlerFehlercodes und -handhabungReferenz

Authentifizierung

Alle API-Anfragen benötigen einen Personal Access Token (PAT), der im Authorization Header übergeben wird:

Authorization: Bearer td_xxxxx...

Holen Sie sich Ihr Token:

  1. Melden Sie sich bei TeamDay an
  2. Navigieren Sie zu Einstellungen → API Zugriff
  3. Klicken Sie auf Neues Token generieren
  4. Kopieren und speichern Sie sicher (wird nur einmal angezeigt)

Mehr über Authentifizierung →

Kernkonzepte

Agenten

Agenten sind KI-Assistenten mit anpassbaren System-Prompts, Rollen und Fähigkeiten. Erstellen Sie Agenten, um Aufgaben zu automatisieren, Daten zu analysieren oder bei Workflows zu helfen.

Beispiel:

# Neuen Agent erstellen
curl -X POST https://us.teamday.ai/api/v1/agents \
  -H "Authorization: Bearer $TEAMDAY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Research Assistant",
    "role": "Research and analysis",
    "systemPrompt": "You are a research assistant...",
    "visibility": "private"
  }'

Vollständige Agent-Dokumentation →

Ausführungen

Ausführungen verfolgen, wann Agenten laufen. Jede Ausführung erfasst die vollständige Geschichte von Nachrichten, Tool-Nutzung und Ergebnissen.

Beispiel:

# Neueste Ausführungen auflisten
curl https://us.teamday.ai/api/v1/executions?limit=10 \
  -H "Authorization: Bearer $TEAMDAY_TOKEN"

Vollständige Ausführungs-Dokumentation →

Aufgaben

Aufgaben stellen Arbeitseinträge dar, die Agenten oder Benutzern zugewiesen sind. Aufgaben können nach Status, Empfänger und Workspace gefiltert werden.

Beispiel:

# Aufgaben auflisten
curl https://us.teamday.ai/api/v1/tasks \
  -H "Authorization: Bearer $TEAMDAY_TOKEN"

Vollständige Aufgaben-Dokumentation →

Häufige Anwendungsfälle

Automatisierung von Aufgaben mit Agenten

# 1. Agent erstellen
agent_id=$(curl -s -X POST https://us.teamday.ai/api/v1/agents \
  -H "Authorization: Bearer $TEAMDAY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{...}' | jq -r '.id')

# 2. Agent ausführen
curl -X POST https://us.teamday.ai/api/v1/agents/$agent_id/execute \
  -H "Authorization: Bearer $TEAMDAY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Analyze this dataset",
    "stream": false
  }'

Workflow-Tracking

# Alle Ausführungen für einen Agent abrufen
curl "https://us.teamday.ai/api/v1/executions?agentId=$agent_id" \
  -H "Authorization: Bearer $TEAMDAY_TOKEN"

Fehlerbehandlung

Die API gibt standardisierte Fehlerresponses zurück. Siehe Fehlerreferenz für Details.

{
  "error": true,
  "statusCode": 400,
  "statusMessage": "Bad Request",
  "message": "Invalid request parameters"
}

Nächste Schritte