API Endpoints

Complete reference for all TeamDay API endpoints. All endpoints require authentication via Personal Access Token.

Base URL

https://us.teamday.ai/api/v1

Authentication

All requests must include your Personal Access Token in the Authorization header:

Authorization: Bearer td_your-token-here

Agents

Manage AI agents (characters) in your organization.

List Agents

Get all agents accessible to your account.

GET /api/v1/agents

Response:

{
  "success": true,
  "agents": [
    {
      "id": "abc123def456",
      "name": "Code Reviewer",
      "role": "Senior Developer",
      "systemPrompt": "You review code for quality...",
      "visibility": "organization",
      "model": "claude-sonnet-4-6",
      "createdAt": "2024-12-09T10:00:00Z"
    }
  ],
  "total": 1
}

Create Agent

Create a new AI agent.

POST /api/v1/agents

Request Body:

{
  "name": "Research Assistant",
  "role": "Researcher",
  "systemPrompt": "You are a helpful research assistant.",
  "visibility": "organization",
  "model": "claude-sonnet-4-6"
}

Execute Agent

Run an agent to process a message.

POST /api/v1/agents/{agentId}/execute

Request Body:

{
  "message": "Analyze this repository",
  "spaceId": "space_abc123",
  "stream": false
}

Tasks

Create and manage coordinated work across agents.

List Tasks

GET /api/v1/tasks

Create Task

POST /api/v1/tasks

Request Body:

{
  "title": "Deploy to production",
  "priority": "high",
  "assignTo": "abc123def456"
}

Executions

Track agent execution history.

List Executions

GET /api/v1/executions?agentId={agentId}

Get Execution Details

GET /api/v1/executions/{executionId}

Get Execution Tree

GET /api/v1/executions/{executionId}/tree

Cancel Execution

POST /api/v1/executions/{executionId}/cancel

Spaces

Manage workspace environments.

List Spaces

GET /api/v1/spaces

Get Space

GET /api/v1/spaces/{id}

Create Space

POST /api/v1/spaces

Update Space

PATCH /api/v1/spaces/{id}

Delete Space

DELETE /api/v1/spaces/{id}

Additional Endpoint Groups

The v1 API also includes endpoints for the following resources. See individual documentation pages for details.

• Characters - Manage AI character configurations
• Missions - Create and manage long-running autonomous tasks
• MCPs - Manage MCP server instances
• Skills - Manage reusable prompt packages
• Keys - Manage Personal Access Tokens
• Media - Upload and manage media assets
• Profile - User profile management

Error Responses

{
  "error": true,
  "statusCode": 400,
  "message": "Validation error"
}

For complete endpoint details, examples, and parameters, see our interactive API documentation.