Teams API

List TeamsCopy Anchor Link

GET /api/v1/teams

Returns all teams the authenticated user is a member of.

Response 200:

[
  {
    "id": "uuid",
    "name": "My Team",
    "slug": "my-team",
    "owner_id": "uuid",
    "plan": "startup",
    "is_active": true,
    "created_at": "2025-01-01T00:00:00Z",
    "updated_at": "2025-01-01T00:00:00Z"
  }
]

Set the ArchetypeCopy Anchor Link

PUT /api/v1/teams/{teamSlug}/archetype

Request: {"archetype": "hospital"}, the archetype of one of the bundles the platform ships, which the bundle list gives.

Sets what the team is for, which picks the bundle it is offered. Only the team's owners and admins may (403 otherwise), and an archetype no bundle is for answers 400 unknown_archetype. Picking again changes which bundle the team is offered and removes no app. The team's archetype is in each of the teams of GET /api/v1/user/me.

Response 200: {"archetype": "hospital"}.