Organization Name - Choose a descriptive name
- Example: "Acme Corp", "My Startup", "Personal Projects"
Organization ID - Auto-generated slug for API access
- Example: acme-corp, my-startup
- Can be customized (lowercase, hyphens only)
Billing Plan - Starts on free tier
- Free: 100 agent executions/month
- Pro: Unlimited executions ($29/month)
- Enterprise: Custom pricing

Click "Create Organization" to continue.

Screenshot

Note: You can create multiple organizations or join existing ones later from your settings.

Step 3: Create a Personal Access Token

Personal Access Tokens (PATs) allow you to authenticate API requests and CLI commands.

Navigate to API Keys

Click your profile icon in the top-right corner
Select "Settings"
Click "API Keys" in the left sidebar

Screenshot

Create Your First Token

Click "+ New Personal Access Token"
Configure the token:
- Name: "Getting Started Token" (or any descriptive name)
- Expiration: Select "90 days" (recommended for testing)
- Scopes: Full access (scopes coming soon)
Click "Create Token"

Screenshot

Save Your Token Securely

⚠️ IMPORTANT: Your token is shown only once!

td_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6

Do this immediately:

Copy the token to your clipboard
Store it securely in a password manager or environment variable
Never commit it to git or share it publicly

Save to environment variable (recommended):

# macOS/Linux - Add to ~/.bashrc or ~/.zshrc
export TEAMDAY_API_TOKEN="td_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"

# Windows PowerShell
$env:TEAMDAY_API_TOKEN="td_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"

Reload your shell:

source ~/.bashrc  # or source ~/.zshrc

Screenshot

If you lose your token: You must revoke it and create a new one. There's no way to retrieve a lost token.

Step 4: Make Your First API Call

Let's verify your token works by calling the TeamDay API.

Test Your Authentication

Using cURL:

curl -X GET "https://cc.teamday.ai/api/v1/agents" \
  -H "Authorization: Bearer $TEAMDAY_API_TOKEN" \
  -H "Content-Type: application/json"

Expected response:

{
  "data": [],
  "count": 0
}

You should see an empty list (since you haven't created any agents yet).

Screenshot

Using JavaScript:

const TEAMDAY_TOKEN = process.env.TEAMDAY_API_TOKEN;

async function listAgents() {
  const response = await fetch('https://cc.teamday.ai/api/v1/agents', {
    headers: {
      'Authorization': `Bearer ${TEAMDAY_TOKEN}`,
      'Content-Type': 'application/json'
    }
  });

  const data = await response.json();
  console.log('Agents:', data);
}

listAgents();

Using Python:

import os
import requests

TEAMDAY_TOKEN = os.environ['TEAMDAY_API_TOKEN']

def list_agents():
    response = requests.get(
        'https://cc.teamday.ai/api/v1/agents',
        headers={
            'Authorization': f'Bearer {TEAMDAY_TOKEN}',
            'Content-Type': 'application/json'
        }
    )
    print('Agents:', response.json())

list_agents()

Troubleshooting API Calls

401 Unauthorized:

Token is invalid or expired
Check that you copied the token correctly
Verify the token exists in Settings → API Keys

403 Forbidden:

Token doesn't have required permissions
Verify you're in the correct organization

Network Errors:

Check your internet connection
Verify the API URL is correct: https://cc.teamday.ai

Step 5: Create Your First Agent

Now let's create an AI agent using the API.

Create Agent via API

Request:

curl -X POST "https://cc.teamday.ai/api/v1/agents" \
  -H "Authorization: Bearer $TEAMDAY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My First Agent",
    "systemPrompt": "You are a helpful assistant that can answer questions and help with tasks. Be concise and friendly.",
    "model": "claude-3-5-sonnet-20241022",
    "visibility": "private"
  }'

Response:

{
  "id": "char_abc123xyz",
  "name": "My First Agent",
  "systemPrompt": "You are a helpful assistant...",
  "model": "claude-3-5-sonnet-20241022",
  "visibility": "private",
  "organizationId": "org_xyz789",
  "createdAt": "2025-01-15T10:00:00Z",
  "updatedAt": "2025-01-15T10:00:00Z"
}

Save the agent ID (char_abc123xyz) - you'll need it to execute the agent.

Screenshot

Create Agent via UI

Prefer a visual interface?

Navigate to "Agents" in the sidebar
Click "+ New Agent"
Fill in the details:
- Name: "My First Agent"
- Model: Select "Claude 3.5 Sonnet"
- System Prompt: Enter the instructions above
- Visibility: Select "Private"
Click "Create Agent"

Screenshot

Test Your Agent

Execute via API:

curl -X POST "https://cc.teamday.ai/api/v1/agents/char_abc123xyz/execute" \
  -H "Authorization: Bearer $TEAMDAY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Hello! What can you help me with?"
  }'

Response:

{
  "executionId": "exec_456def",
  "message": "Hello! I'm your helpful assistant. I can help you with a variety of tasks including answering questions, providing information, helping with analysis, and more. What would you like assistance with today?",
  "usage": {
    "inputTokens": 245,
    "outputTokens": 89
  },
  "status": "completed"
}