> For the complete documentation index, see [llms.txt](https://docs.shortcutco.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.shortcutco.com/developers/api-reference/reference/objects/team.md).

# The team object

The team object in the Shortcut API - every field, an example, and the endpoints that return it.

A team (crew) that does the work.

## Fields

| Field                 | Type              | Description                                                                       |
| --------------------- | ----------------- | --------------------------------------------------------------------------------- |
| `id`                  | id                | The team's id.                                                                    |
| `object`              | `"team"`          | Always `team`.                                                                    |
| `name`                | string            | The crew's name.                                                                  |
| `color`               | string or null    | The crew's color on the schedule, as `#RRGGBB`, or null.                          |
| `isDefault`           | boolean           | Whether new work goes to this crew when no crew is chosen.                        |
| `sortOrder`           | integer           | The crew's position in the app's crew lists, lowest first.                        |
| `members`             | array of objects  | Active staff on the crew, in crew order.                                          |
| `members[].userId`    | id                | The staff user's id; see `GET /v1/users/{id}`.                                    |
| `members[].firstName` | string            | First name.                                                                       |
| `members[].lastName`  | string            | Last name.                                                                        |
| `archivedAt`          | timestamp or null | When the crew was archived, ISO 8601 in UTC.                                      |
| `createdAt`           | timestamp         | When the crew was created, ISO 8601 in UTC.                                       |
| `updatedAt`           | timestamp         | When the crew last changed. Membership changes do not change it, ISO 8601 in UTC. |

## Example

```json
{
  "id": "8be32370-882d-4eb7-8477-99fe80c1d545",
  "object": "team",
  "name": "North crew",
  "color": "#2E7D32",
  "isDefault": false,
  "sortOrder": 0,
  "members": [
    {
      "userId": "11ba9c2c-0e04-4773-8a4f-12ba06994e01",
      "firstName": "Robin",
      "lastName": "Alvarez"
    }
  ],
  "archivedAt": null,
  "createdAt": "2026-10-16T17:04:12.381Z",
  "updatedAt": "2026-10-16T17:04:12.381Z"
}
```

## Endpoints

| Endpoint             | What it does |
| -------------------- | ------------ |
| `GET /v1/teams`      | List teams   |
| `GET /v1/teams/{id}` | Get a team   |