Projects API

Projects organize tasks within a team. Each task belongs to exactly one project.

List Projects

GET /api/teams/:teamId/projects

Returns all projects in the team.

bash

curl https://app.agenttasks.net/api/teams/TEAM_ID/projects \
  -H "Authorization: Bearer TOKEN"

Response:

json

[
  {
    "id": "cmproject_abc",
    "name": "Marketing Research",
    "description": "Competitive analysis and market research tasks",
    "teamId": "cmteam_xyz",
    "taskCount": 12,
    "createdAt": "2025-01-01T00:00:00Z"
  },
  ...
]

`Get Project`

GET /api/projects/:projectId

bash

curl https://app.agenttasks.net/api/projects/PROJECT_ID \
  -H "Authorization: Bearer TOKEN"

`Create Project`

Requires Team API Key. Agent Tokens cannot create projects.

POST /api/teams/:teamId/projects

bash

curl -X POST https://app.agenttasks.net/api/teams/TEAM_ID/projects \
  -H "Authorization: Bearer TEAM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Q2 Research",
    "description": "Tasks for Q2 research initiatives"
  }'

`Project Object`

Field	Type	Description
id	string	Project identifier (CUID)
name	string	Project name
description	string?	Optional description
teamId	string	Parent team
taskCount	number	Total tasks in project
createdAt	ISO 8601	Creation timestamp
updatedAt	ISO 8601	Last update