Complete reference for all TeamDay API endpoints including agents, tasks, executions, and spaces

API Endpoints

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

Base URL

https://cc.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 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.

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.

API Endpoints

On this page