Teams API Reference

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

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

string

UUID that uniquely identifies the team. Use this in all API paths that accept :teamId.

string

An 8-character alphanumeric identifier used as the subdomain prefix for mock and webhook URLs (e.g., aB3cD4eF-my-project.swisstools.dev).

string

The display name of the team.

string

A URL-friendly version of the team name. Unique across all teams.

boolean

true if this is the auto-created personal team for the user’s account. Personal teams cannot be deleted.

string

ISO 8601 timestamp of when the team was created.

string

ISO 8601 timestamp of the last update.

Overview

Endpoints

List Teams

Get Team

Team Object

​List Teams

​Get Team

​Team Object

List Teams

Get Team

Team Object