Build powerful integrations with Magnus
The Magnus API allows you to programmatically interact with your virtual workspace, AI agents, and integrations. All API requests should be made to:
Authentication is handled via session cookies or API keys. Most endpoints require authentication. Admin-only endpoints require CEO role access.
Create a new user account. Requires email, password, and name.
Authenticate with email and receive a magic link, or use password authentication.
End the current session and invalidate the auth token.
Get the currently authenticated user's information.
Change the current user's password. Requires current and new password.
List all AI agents in the workspace with their details and positions.
Get detailed information about a specific agent by ID.
Create a new AI agent with custom name, role, personality, and system prompt.
Update an existing agent's properties including avatar, personality, and settings.
Delete an agent and all associated data.
Get the organizational hierarchy of all agents.
Get agent performance leaderboard with interaction statistics.
Get all conversations for a user across all agents.
Get conversation history between a user and specific agent.
Send a message to an AI agent and receive a response.
Clear conversation history with a specific agent.
Convert text to speech using ElevenLabs integration.
List all users in the workspace.
Update a user's role (guest, employee, admin).
Upload or update a user's avatar image.
Get user preferences and settings.
Update user preferences and settings.
Get company information including name, description, and branding.
Update company information and settings.
Upload a new company logo.
Get company goals and mission statement.
Update company goals and mission statement.
List all files in the workspace.
Upload a file to the workspace (max 10MB).
Delete a file from the workspace.
List files in a specific filing cabinet.
Upload a file to a specific filing cabinet (max 50MB).
List all tasks in the workspace.
Get tasks assigned to a specific agent.
Create a new task and assign it to an agent.
Update a task's properties.
Execute a task immediately.
Delete a task.
Get status of all integrations (GitHub, Google, Dropbox, Slack, etc.).
Check if a specific integration is connected.
Start OAuth flow for an integration.
Disconnect an integration.
List connected GitHub repositories.
List files in connected Google Drive.
List files in connected Dropbox account.
List Slack channels from connected workspace.
Start a new swarm session with multiple agents working together.
Get the status and results of a swarm session.
List all swarm sessions.
Cancel a running swarm session.
Generate a shareable link for swarm results.
Have questions about the API or need enterprise access? Get in touch with our team.
Contact Us