---
title: "GetTeamSettings"
method: GET
path: "/teams/{team_slug}/settings"
tags: ["Teams"]
---

# GetTeamSettings

`GET /teams/{team_slug}/settings`

Get team settings page.

Returns:
    Team details, members list, pending invitations, and user permissions for management.

## Path parameters

- `team_slug` string, required — The team slug.

## Response `200`

Request fulfilled, document follows

- TeamDetailPage
  - `members` TeamPageMember[], required
    - `avatarUrl` string, nullable
    - `email` string, required
    - `id` string, uuid, required
    - `name` string, nullable
    - `role` string, required
    - `userId` string, uuid, required
  - `pendingInvitations` TeamInvitationItem[]
    - `createdAt` string, date-time, required
    - `email` string, required
    - `expiresAt` string, date-time, nullable
    - `id` string, uuid, required
    - `invitedByEmail` string, required
    - `inviteeExists` boolean
    - `isExpired` boolean
    - `role` string, required
  - `permissions` TeamPermissions, required
    - `canAddTeamMembers` boolean, required
    - `canDeleteTeam` boolean, required
    - `canRemoveTeamMembers` boolean, required
    - `canUpdateTeam` boolean, required
  - `team` TeamDetail, required
    - `createdAt` string, date-time, nullable
    - `description` string, nullable
    - `id` string, uuid, required
    - `name` string, required
    - `slug` string, required
    - `tags` TeamTag[]
      - `id` string, uuid, required
      - `name` string, required
      - `slug` string, required

## Other responses

- `400` — Bad request syntax or unsupported method

## Changes

- **2026-07-17** `461f3baecebb` — 1 info
  - added the optional property `team/tags` to the response with the `200` status
- **2025-12-22** `6b2fad3e4bcc` — 1 warning
  - removed the optional property `team/tags` from the response with the `200` status

[Change history](https://skmtc.dev/litestar-org/apis/app/changes/teams/:team_slug/settings/get.md)

---

[API](https://skmtc.dev/litestar-org/apis/app.md) · [All operations](https://skmtc.dev/litestar-org/apis/app/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/litestar-org/app/revisions/461f3baecebb/schema)