---
title: "Read Team"
method: GET
path: "/api/v1/teams/{team_id_or_identifier}"
tags: ["teams"]
---

# Read Team

`GET /api/v1/teams/{team_id_or_identifier}`

## Request

- Base URL: `https://api.gnosari.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.gnosari.com/api/v1/teams/{team_id_or_identifier}`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-AUTH-TOKEN`

Get team by ID or identifier.

Requires authentication (JWT or API key). Returns the full team
for the authenticated user's account only.

Supports both numeric IDs (e.g., 123) and string identifiers
(e.g., "dev-team").

## Path parameters

- `team_id_or_identifier` string, required

## Response `200`

Successful Response

- Team: Full team schema with database fields and agent list.
  - `name` string, required
  - `description` string, nullable
  - `identifier` string, nullable
  - `parameters` unknown[], nullable
    - unknown
  - `image` string, nullable
  - `version` string
  - `tags` string[]
  - `config` object, nullable
  - `components_include` string[], nullable
  - `components_exclude` string[], nullable
  - `created_by` string, nullable
  - `access_level` 'PRIVATE' | 'PASSWORD_PROTECTED' | 'PUBLIC'
  - `access_password` string, nullable
  - `suggested_prompts` SuggestedPromptsConfigSchema: Schema for suggested prompts configuration. Used in Agent and Team create/update operations. Provides a complete configuration including enabled state and the list of prompts.
    - `enabled` boolean: Whether to show suggested prompts in chat
    - `prompts` CoreSchemasSuggestedPromptSuggestedPromptSchema[]: List of suggested prompts (max 8)
      - `id` union, required: Unique identifier for the prompt
        - integer
        - string
      - `icon` string: Heroicons icon name (e.g., 'i-heroicons-light-bulb')
      - `title` string, required: Short title displayed on the prompt button
      - `text` string, required: The actual prompt text sent when clicked
  - `id` integer, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, nullable
  - `agents` Agent[]

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/gnosari/apis/gnosari-api.md) · [All operations](https://skmtc.dev/gnosari/apis/gnosari-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gnosari/apis/gnosari-api/revisions/f299cf53ae5f?raw)