Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: Flipletters Com Teams API
version: 1.0.0
contact:
name: FlipLetters
email: dev@flipletters.com
url: https://flipletters.com/docs/api
license:
name: Proprietary Studio API; flipcode parser is MIT
url: https://www.npmjs.com/package/@flipletters/flipcode
description: 'Operations tagged Teams across 2 of this provider''s published API definitions: openapi.json, flipletters-com-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://app.flipletters.com
description: FlipLetters Studio (live HTTP API)
tags:
- name: Teams
description: 'Shared template library (scope: team)'
paths:
/api/team:
post:
tags:
- Teams
summary: Team library actions (create, join, list, share, …)
operationId: postTeam
security:
- bearerAuth: []
description: One POST endpoint; the JSON `action` field selects the operation. Creating a team is a Premium perk; joining by invite is free.
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- action
properties:
action:
type: string
enum:
- listTeams
- create
- join
- listTemplates
- leave
- share
- removeTemplate
name:
type: string
code:
type: string
description: Invite code for join
teamId:
type: string
project:
type: object
additionalProperties: true
description: Required for action=share
templateId:
type: string
responses:
'200':
description: Action-specific JSON (teams, teamId, templates, …)
'400':
$ref: '#/components/responses/ApiError'
'401':
$ref: '#/components/responses/ApiError'
'402':
$ref: '#/components/responses/ApiError'
'403':
$ref: '#/components/responses/ApiError'
'404':
$ref: '#/components/responses/ApiError'
'500':
$ref: '#/components/responses/ApiError'
servers:
- url: https://app.flipletters.com
description: FlipLetters Studio (live HTTP API)
components:
responses:
ApiError:
description: Structured FlipLetters API error
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
schemas:
ApiError:
type: object
required:
- error
- code
- hint
properties:
error:
type: string
description: Human-readable message (string, for existing Studio UI)
code:
type: string
description: Stable machine code, e.g. NOT_FOUND
hint:
type: string
description: Resolution hint for agents and humans
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: Firebase ID token or Studio API key `flk_…`. Keys are created by a signed-in human; they are never self-issued by agents.
firebaseSession:
type: http
scheme: bearer
description: Firebase ID token only (browser Studio session). API keys are rejected.
x-refined-from:
- openapi.json
- flipletters-com-openapi.json
x-provenance:
method: harvested
publisher: FlipLetters
source: https://flipletters.com/openapi.json
note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
stamped by stamp-openapi-provenance.py (roadmap#793)