API TeamDay v1 - Aperçu

L’API TeamDay permet aux développeurs d’interagir de manière programmatique avec la plateforme IA TeamDay. Construisez des intégrations personnalisées, automatisez des workflows et gérez des agents IA via une simple API REST.

URL de base : https://us.teamday.ai/api/v1

Statut actuel : 87,5% fonctionnel (7 sur 8 endpoints testés opérationnels)

---

Démarrage rapide

# 1. Obtenez votre jeton API depuis Paramètres → Accès API
export TEAMDAY_TOKEN="td_votre_jeton_ici"

# 2. Faites votre première requête
curl https://us.teamday.ai/api/v1/agents \
  -H "Authorization: Bearer $TEAMDAY_TOKEN"

---

Groupes API

L’API TeamDay v1 est organisée en groupes de ressources suivants :

Ressource	Description	Endpoints
Authentification	Jetons d’accès personnels (PAT)	Gestion des jetons
Agents	Créer et gérer des agents IA	6 endpoints
Exécutions	Suivre l’historique d’exécution des agents	4 endpoints
Tâches	Gérer les tâches et workflows	2 endpoints
Erreurs	Codes d’erreur et gestion	Référence

---

Authentification

Toutes les requêtes API nécessitent un jeton d’accès personnel (PAT) passé dans l’en-tête Authorization :

Authorization: Bearer td_xxxxx...

Obtenez votre jeton :

1. Connectez-vous à TeamDay
2. Naviguez vers Paramètres → Accès API
3. Cliquez sur Générer un nouveau jeton
4. Copiez et stockez en sécurité (affiché une seule fois)

En savoir plus sur l’authentification →

---

Concepts de base

Agents

Les agents sont des assistants IA avec des prompts système, rôles et capacités personnalisables. Créez des agents pour automatiser des tâches, analyser des données ou assister avec des workflows.

Exemple :

# Créer un nouvel agent
curl -X POST https://us.teamday.ai/api/v1/agents \
  -H "Authorization: Bearer $TEAMDAY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Assistant de recherche",
    "role": "Recherche et analyse",
    "systemPrompt": "Vous êtes un assistant de recherche...",
    "visibility": "private"
  }'

Voir la documentation complète des agents →

Exécutions

Les exécutions suivent quand les agents s’exécutent. Chaque exécution capture l’historique complet des messages, l’utilisation des outils et les résultats.

Exemple :

# Lister les exécutions récentes
curl https://us.teamday.ai/api/v1/executions?limit=10 \
  -H "Authorization: Bearer $TEAMDAY_TOKEN"

Voir la documentation complète des exécutions →

Tâches

Les tâches représentent des éléments de travail assignés à des agents ou des utilisateurs. Les tâches peuvent être filtrées par statut, assigné et espace de travail.

Exemple :

# Lister les tâches en attente
curl https://us.teamday.ai/api/v1/tasks?status=pending \
  -H "Authorization: Bearer $TEAMDAY_TOKEN"

Voir la documentation complète des tâches →

---

Format de réponse

Toutes les réponses suivent une structure JSON cohérente :

Réponse de succès

{
  "id": "agent_123",
  "name": "Assistant de recherche",
  "createdAt": "2025-12-09T12:00:00Z",
  "...": "..."
}

Réponse d’erreur

{
  "error": true,
  "statusCode": 400,
  "statusMessage": "Bad Request",
  "message": "Missing required field: name"
}

Voir la référence des erreurs →

---

Limites de débit

Actuellement, l’API n’applique pas de limites de débit. Cela peut changer à l’avenir. Bonnes pratiques :

• Utiliser des taux de requête raisonnables
• Implémenter un backoff exponentiel pour les nouvelles tentatives
• Mettre en cache les réponses lorsque approprié
• Considérer les webhooks pour les mises à jour en temps réel (à venir)

---

Pagination

Les endpoints de liste supportent la pagination via des paramètres de requête :

# Obtenir 50 résultats (limite par défaut)
curl https://us.teamday.ai/api/v1/executions \
  -H "Authorization: Bearer $TEAMDAY_TOKEN"

# Spécifier une limite personnalisée
curl https://us.teamday.ai/api/v1/executions?limit=100 \
  -H "Authorization: Bearer $TEAMDAY_TOKEN"

Paramètres :

• limit - Nombre maximum de résultats par requête (par défaut : 50)

---

Filtrage

La plupart des endpoints de liste supportent le filtrage via des paramètres de requête :

# Filtrer les exécutions par agent
curl "https://us.teamday.ai/api/v1/executions?agentId=agent_123" \
  -H "Authorization: Bearer $TEAMDAY_TOKEN"

# Filtrer les tâches par statut et espace
curl "https://us.teamday.ai/api/v1/tasks?status=pending&spaceId=space_456" \
  -H "Authorization: Bearer $TEAMDAY_TOKEN"

Consultez la documentation des endpoints individuels pour les filtres disponibles.

---

Types de données

Horodatages

Tous les horodatages sont des chaînes ISO 8601 en UTC :

{
  "createdAt": "2025-12-09T12:00:00Z",
  "updatedAt": "2025-12-09T14:30:00Z"
}

IDs

Les ressources utilisent des IDs de chaîne avec des préfixes pour la sécurité de type :

• agent_ - IDs d’agent
• exec_ - IDs d’exécution
• task_ - IDs de tâche
• space_ - IDs d’espace
• org_ - IDs d’organisation
• td_ - Jetons d’accès personnels

Visibilité

Les agents et ressources supportent trois niveaux de visibilité :

• private - Visible uniquement par le créateur
• organization - Visible par les membres de l’organisation
• public - Visible par tous (futur)

---

Problèmes connus

Exécution d’agent (CASSÉ)

Statut : 🔴 Problème critique

L’endpoint /api/v1/agents/[id]/execute retourne actuellement une erreur 500 due à un problème de service interne. Nous travaillons activement sur une correction.

Solution de contournement : Utiliser l’interface web pour l’exécution d’agents jusqu’à résolution.

Endpoints affectés :

• POST /api/v1/agents/[id]/execute

Suivre le statut du problème →

---

Journal des modifications de l’API

9 décembre 2025

Statut :

• ✅ 7/8 endpoints testés fonctionnels (87,5%)
• 🔴 Endpoint d’exécution d’agent temporairement indisponible
• 🟡 Endpoints supplémentaires non testés (tâches, exécutions)

Authentification :

• ✅ Système de jetons PAT entièrement opérationnel
• ✅ Validation du hachage SHA-256
• ✅ Chiffrement AES-256-GCM au repos
• ✅ Gestion automatique de l’expiration (7-365 jours)

CRUD Agent :

• ✅ Lister les agents
• ✅ Créer un agent
• ✅ Obtenir les détails d’un agent
• ✅ Mettre à jour un agent
• ✅ Supprimer un agent (suppression logique)

---

Support et communauté

Documentation :

• Référence API
• Bonnes pratiques
• Exemples

Besoin d’aide ?

• 📧 Email : support at teamday.ai
• 💬 Discord : Rejoindre la communauté
• 🐛 Problèmes : GitHub

---

Prochaines étapes

1. S’authentifier - Générer votre jeton API
2. Créer un agent - Construire votre premier assistant IA
3. Voir des exemples - Voir des cas d’utilisation réels
4. Apprendre les bonnes pratiques - Optimiser votre intégration

---

Dernière mise à jour : 9 décembre 2025