---
title: "Team library actions (create, join, list, share, …)"
method: POST
path: "/api/team"
tags: ["Teams"]
---

# Team library actions (create, join, list, share, …)

`POST /api/team`

## Request

- Base URL: `https://app.flipletters.com`
- URL: `https://app.flipletters.com/api/team`
- Auth: HTTP bearer

One POST endpoint; the JSON `action` field selects the operation. Creating a team is a Premium perk; joining by invite is free.

## Request body

- object
  - `action` 'listTeams' | 'create' | 'join' | 'listTemplates' | 'leave' | 'share' | 'removeTemplate', required
  - `name` string
  - `code` string: Invite code for join
  - `teamId` string
  - `project` object: Required for action=share
  - `templateId` string

## Response `200`

Action-specific JSON (teams, teamId, templates, …)

## Other responses

- `400`: Structured FlipLetters API error
- `401`: Structured FlipLetters API error
- `402`: Structured FlipLetters API error
- `403`: Structured FlipLetters API error
- `404`: Structured FlipLetters API error
- `500`: Structured FlipLetters API error

---

[API](https://skmtc.dev/flipletters/apis/flipletters-api.md) · [All operations](https://skmtc.dev/flipletters/apis/flipletters-api/llms.txt) · [OpenAPI document](https://skmtc.dev/flipletters/apis/flipletters-api/revisions/26324feeb585?raw)