slug and its team’s referenceId together form the subdomain used to serve mock and webhook traffic.
All project endpoints require session authentication. See Authentication for details.
List Projects
GET /api/teams/:teamId/projects
Returns all projects that belong to the specified team.
Path Parameters
Request
Create Project
POST /api/teams/:teamId/projects
Creates a new project within the specified team.
Path Parameters
Request Body
A URL-friendly identifier. Used as part of the subdomain for mock and webhook URLs. Must be unique within the team.
201 Created
Get Project
GET /api/teams/:teamId/projects/:projectId
Returns a single project by its ID.
Path Parameters
Request
Update Project
PUT /api/teams/:teamId/projects/:projectId
Updates the name, slug, or description of an existing project.
Path Parameters
Request Body
Updated URL-friendly slug. Changing the slug also changes the subdomain used for mocks and webhooks.
Delete Project
DELETE /api/teams/:teamId/projects/:projectId
Permanently deletes a project and all of its resources — mocks, webhooks, feature flags, API keys, and release notes are all removed. This action cannot be undone.
Path Parameters
Request
Project Object
URL-friendly identifier. Combined with the team’s
referenceId to form the subdomain: <referenceId>-<slug>.swisstools.dev.