Teams API

A team groups users under a manager so you can route and report on work by group rather than by individual. Use this API to create teams, change membership, nest them into a hierarchy, and read the projects each one owns.

Create a team

Only team_name is required. You can name the manager_id and seed members at creation, or add them afterward.

curl https://algapsa.com/api/v1/teams \
  -H "X-API-Key: $ALGA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "team_name": "Tier 2 Support",
    "manager_id": "usr_4b1c",
    "members": ["usr_91af", "usr_7d20"]
  }'

Members and manager

List the roster with GET /teams/{id}/members, add one with POST /teams/{id}/members, or load several through POST /teams/{id}/members/bulk. Remove a person with DELETE /teams/{id}/members/{userId}, and set the lead with PUT /teams/{id}/manager.

Hierarchy and reporting

Attach a team under a parent with POST /teams/{id}/hierarchy and read the whole tree from GET /teams/hierarchy. For output, GET /teams/{id}/projects lists what a team is working on and GET /teams/{id}/analytics rolls up its numbers.

Find teams

GET /teams lists and filters, GET /teams/search runs a text query, and GET /teams/stats returns aggregate counts.

Endpoints

Every endpoint links through to its full parameters, request and response schemas, and code samples.