---
title: "Teams API"
canonical: "https://support.appfire.com/space/FD/1802011038/Teams%20API"
format: markdown
---
> Macro (aura-html)

A team represents a group of Flow users.

This endpoint has the following methods:

- `GET /teams/`: Gets a list of teams and their associated information.
- `POST /teams/`: Creates a new team.
- `GET /teams/{id}`: Gets information for a team by ID.
- `PUT /teams/{id}`: Updates team information by ID.
- `DELETE /teams/{id}`: Deletes a team by ID.

## Fields

| Name | Type | Description |
| --- | --- | --- |
| `id` | double | Unique identifier for a team. |
| `name` | string | Name of a team. |
| `vendor` | string | Name of a vendor. |
| `description__icontains` | string | Team description contains this string. |
| `description__isnull` | string | Team description is null. |
| `parent` | integer | parent_id (if team is child). |
| `parent__isnull` | string | Parent team is null. |
| `is_visible` | string | Team is visible in report menus. |
| `created_at` | string | Date and time a team was created. |

## Example response

```json
 "id": 204215,
      "name": "Engineers",
      "description": null,
      "org": 1234,
      "avatar": null,
      "vendor": null,
      "created_at": "2024-10-08T17:49:34.204286",
      "parent": null,
      "path": "204215",
      "ancestors": [
        "Technology"
      ],
      "visibility": "SHOW",
      "team_level": 1,
      "inherited_depth": "aggregate",
      "nested_teams": 0,
      "all_users": 0,
      "unnested_users": 0,
      "depth": "inherit"
    }
```