Teams

Create Team Run

Execute a team collaboration with multiple agents working together on a task.

Features:

Text message input with optional session management
Multi-media support: images (PNG, JPEG, WebP), audio (WAV, MP3), video (MP4, WebM, etc.)
Document processing: PDF, CSV, DOCX, TXT, JSON
Real-time streaming responses with Server-Sent Events (SSE)
User and session context preservation

Streaming Response: When stream=true, returns SSE events with event and data fields.

post/teams/{team_id}/runs

Request

The document declares no server URL.
Auth
HTTP bearer
TypeScript
https://skmtc.dev/agno/apis/agno-api-reference/docs/teams/:team_id/runs/post.ts
A function with typed inputs. Its response is checked against the schema.

team_idstring required

messagestring required

The input message or prompt to send to the team

streamboolean

Enable streaming responses via Server-Sent Events (SSE)

monitorboolean

Enable monitoring and logging for this run

session_idstring nullable

Session ID for conversation continuity. If not provided, a new session is created

user_idstring nullable

User identifier for tracking and personalization

filesstring[] nullable

Files to upload (images, audio, video, or documents)

versioninteger nullable

Team version to use for this run

backgroundboolean

Run in background and return immediately with run metadata (requires database)

factory_inputstring nullable

JSON object with factory-specific parameters for dynamic team construction

Team run executed successfully

unknown required

No recorded changes to this operation across all 1 revision of this API.