Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.swisstools.dev/llms.txt

Use this file to discover all available pages before exploring further.

Teams are the top-level organizational unit in Swisstools. Every account has at least one team — a personal team provisioned automatically on signup. You can also belong to additional shared teams. All projects, mocks, webhooks, and feature flags are owned by a team through a project. All team endpoints require a valid session cookie. See Authentication for details.

​
List Teams

GET /api/teams Returns all teams that the authenticated user belongs to. Request 
curl https://swisstools.dev/api/teams \
  -b cookies.txt
Response 
[
  {
    "id": "018e4f2a-1c3d-7b8e-9f0a-2b3c4d5e6f7a",
    "referenceId": "aB3cD4eF",
    "name": "Acme Corp",
    "slug": "acme-corp",
    "isPersonal": false,
    "createdAt": "2024-01-15T09:00:00.000Z",
    "updatedAt": "2024-01-15T09:00:00.000Z"
  },
  {
    "id": "018e4f2a-2d4e-8c9f-a0b1-3c4d5e6f7a8b",
    "referenceId": "xY7zA1bC",
    "name": "Jane Doe",
    "slug": "jane-doe",
    "isPersonal": true,
    "createdAt": "2024-01-01T00:00:00.000Z",
    "updatedAt": "2024-01-01T00:00:00.000Z"
  }
]

​
Get Team

GET /api/teams/:teamId Returns a single team by its ID. Path Parameters
​
teamId
string
required
The UUID of the team.
Request 
curl https://swisstools.dev/api/teams/018e4f2a-1c3d-7b8e-9f0a-2b3c4d5e6f7a \
  -b cookies.txt
Response 
{
  "id": "018e4f2a-1c3d-7b8e-9f0a-2b3c4d5e6f7a",
  "referenceId": "aB3cD4eF",
  "name": "Acme Corp",
  "slug": "acme-corp",
  "isPersonal": false,
  "createdAt": "2024-01-15T09:00:00.000Z",
  "updatedAt": "2024-01-15T09:00:00.000Z"
}

​
Team Object

​
id
string
UUID that uniquely identifies the team. Use this in all API paths that accept :teamId.
​
referenceId
string
An 8-character alphanumeric identifier used as the subdomain prefix for mock and webhook URLs (e.g., aB3cD4eF-my-project.swisstools.dev).
​
name
string
The display name of the team.
​
slug
string
A URL-friendly version of the team name. Unique across all teams.
​
isPersonal
boolean
true if this is the auto-created personal team for the user’s account. Personal teams cannot be deleted.
​
createdAt
string
ISO 8601 timestamp of when the team was created.
​
updatedAt
string
ISO 8601 timestamp of the last update.