TeamDay.ai
← Docs

Guía de API de Misiones

Crea y gestiona misiones automáticamente a través de la API de TeamDay.

Crear una Misión

Solicitud:

curl -X POST "https://us.teamday.ai/api/v1/missions" \
  -H "Authorization: Bearer $TEAMDAY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Daily Report",
    "agentId": "char_abc123",
    "spaceId": "s-space123",
    "frequency": "daily",
    "time": "09:00",
    "timezone": "America/New_York",
    "instructions": "Generate daily analytics report and save to /reports/"
  }'

Respuesta:

{
  "id": "mission_abc123",
  "name": "Daily Report",
  "agentId": "char_abc123",
  "frequency": "daily",
  "status": "active",
  "nextRun": "2025-01-16T09:00:00Z",
  "createdAt": "2025-01-15T10:00:00Z"
}

Listar Misiones

curl -X GET "https://us.teamday.ai/api/v1/missions" \
  -H "Authorization: Bearer $TEAMDAY_API_TOKEN"

Obtener Misión

curl -X GET "https://us.teamday.ai/api/v1/missions/<mission-id>" \
  -H "Authorization: Bearer $TEAMDAY_API_TOKEN"

Actualizar Misión

curl -X PATCH "https://us.teamday.ai/api/v1/missions/<mission-id>" \
  -H "Authorization: Bearer $TEAMDAY_API_TOKEN" \
  -d '{
    "frequency": "weekly",
    "time": "10:00",
    "instructions": "Updated instructions"
  }'

Ejecutar Misión Ahora

curl -X POST "https://us.teamday.ai/api/v1/missions/<mission-id>/execute" \
  -H "Authorization: Bearer $TEAMDAY_API_TOKEN"

Pausar/Reanudar Misión

Pausar:

curl -X POST "https://us.teamday.ai/api/v1/missions/<mission-id>/pause" \
  -H "Authorization: Bearer $TEAMDAY_API_TOKEN"

Reanudar:

curl -X POST "https://us.teamday.ai/api/v1/missions/<mission-id>/resume" \
  -H "Authorization: Bearer $TEAMDAY_API_TOKEN"

Obtener Historial de Ejecuciones

curl -X GET "https://us.teamday.ai/api/v1/missions/<mission-id>/executions" \
  -H "Authorization: Bearer $TEAMDAY_API_TOKEN"

Eliminar Misión

curl -X DELETE "https://us.teamday.ai/api/v1/missions/<mission-id>" \
  -H "Authorization: Bearer $TEAMDAY_API_TOKEN"

Parámetros de Frecuencia

  • once - Una sola vez
  • daily - Diariamente
  • weekly - Semanalmente (especifica dayOfWeek)
  • monthly - Mensualmente
  • cron - Expresión cron personalizada

Ejemplos

Misión Semanal:

curl -X POST "https://us.teamday.ai/api/v1/missions" \
  -H "Authorization: Bearer $TEAMDAY_API_TOKEN" \
  -d '{
    "name": "Weekly Sync",
    "agentId": "char_123",
    "frequency": "weekly",
    "dayOfWeek": "monday",
    "time": "02:00",
    "instructions": "Sync data from external API"
  }'

Misión con Cron:

curl -X POST "https://us.teamday.ai/api/v1/missions" \
  -H "Authorization: Bearer $TEAMDAY_API_TOKEN" \
  -d '{
    "name": "Complex Schedule",
    "agentId": "char_123",
    "frequency": "cron",
    "cronExpression": "0 9 * * MON,WED,FRI",
    "instructions": "Run on Monday, Wednesday, Friday at 9 AM"
  }'

Códigos de Error

  • 400 - Solicitud inválida
  • 401 - No autorizado
  • 404 - Misión no encontrada
  • 500 - Error del servidor

Próximos Pasos