IndigiArmorIndigiArmorDocs

Teams

Organize your users into teams for granular access control and usage tracking. Teams belong to an organization and members are assigned by user ID.

Plan requirement: Multi-team workspaces require the multiTeamWorkspaces feature, available on Professional plans and above.

GET
/v1/teams

List all teams for your organization.

Response

200 OK
{
  "teams": [
    {
      "id": "uuid",
      "organization_id": "uuid",
      "name": "Engineering",
      "created_at": "2026-01-15T10:00:00Z"
    },
    {
      "id": "uuid",
      "organization_id": "uuid",
      "name": "Research",
      "created_at": "2026-01-14T08:00:00Z"
    }
  ]
}
POST
/v1/teams

Create a new team.

Request Body

ParameterTypeRequiredDescription
namestringYesDisplay name for the team (must be unique within the organization)

Create Response

201 Created
{
  "team": {
    "id": "uuid",
    "organization_id": "uuid",
    "name": "Engineering",
    "created_at": "2026-01-15T10:00:00Z"
  }
}

Duplicate team names within the same organization return a 400 error.

PUT
/v1/teams/:id

Update an existing team.

Path Parameters

ParameterTypeRequiredDescription
idstringYesThe team ID

Update Body

ParameterTypeRequiredDescription
namestringNoUpdated team name

Update Response

200 OK
{
  "team": {
    "id": "uuid",
    "organization_id": "uuid",
    "name": "Platform Engineering",
    "created_at": "2026-01-15T10:00:00Z"
  }
}
DELETE
/v1/teams/:id

Delete a team permanently.

Path Parameters

ParameterTypeRequiredDescription
idstringYesThe team ID

Delete Response

200 OK
{ "deleted": true }
GET
/v1/teams/:id/members

List all members assigned to a team.

Path Parameters

ParameterTypeRequiredDescription
idstringYesThe team ID

Members Response

200 OK
{
  "members": [
    {
      "id": "uuid",
      "full_name": "Jane Smith",
      "email": "jane@example.com",
      "role": "admin"
    },
    {
      "id": "uuid",
      "full_name": "Alex Johnson",
      "email": "alex@example.com",
      "role": "member"
    }
  ]
}
POST
/v1/teams/:id/members

Add a member to a team by assigning their user ID.

Path Parameters

ParameterTypeRequiredDescription
idstringYesThe team ID

Request Body

ParameterTypeRequiredDescription
user_idstringYesThe user ID to assign to this team

Add Member Response

200 OK
{ "success": true }

The user must belong to the same organization as the team. Adding a member moves them from their current team (if any) to the specified team.

Examples

SDK
// Create a team
const team = await armor.createTeam({ name: 'Engineering' });

// List all teams
const teams = await armor.listTeams();

// Update a team
await armor.updateTeam(team.id, { name: 'Platform Engineering' });

// Add a member to a team
await armor.addTeamMember(team.id, { user_id: 'user-uuid' });

// List team members
const members = await armor.listTeamMembers(team.id);

// Delete a team
await armor.deleteTeam(team.id);
cURL — Create
curl -X POST https://indigiarmor.com/v1/teams \
  -H "Authorization: Bearer ia_sk_..." \
  -H "Content-Type: application/json" \
  -d '{"name": "Engineering"}'