> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://contentful.com/developers/docs/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://contentful.com/_mcp/server.

A **team** is a group of users in your organization. Teams can be given access to a space (via [team space memberships](/references/user-management-api/team-space-memberships)) in the same way an individual user can.

### Get all teams for an organization

[Get all teams for an organization](/references/user-management-api/teams/get-all-teams-for-an-organization)

This endpoint returns a paginated collection of all teams in this organization.

All organization members can access this endpoint.

#### Query Parameters

| Name            | Details | Description                                                                                         |
| --------------- | ------- | --------------------------------------------------------------------------------------------------- |
| `skip`, `limit` | -       | Specify requested page of result set. See [Pagination](#/introduction/pagination) for more details. |

#### Response

```js
{
    "total": 1,
    "limit": 25,
    "skip": 0,
    "sys": {
        "type": "Array"
    },
    "items": [{
        "name": "Home Department",
        "description": "Furniture and accessories",
        "sys": {
            "id": "2v0NGpymMx5dc1sWjtiarg",
            "type": "Team",
            "organization": {
                "sys": {
                    "type": "Link",
                    "linkType": "Organization",
                    "id": "4EJGvuLTBUMG2A6wS8gfAS"
                }
            },
            "createdAt": "2373-05-20T00:50:57.521Z",
            "updatedAt": "3882-12-12T21:02:17.948Z",
            "createdBy": {
                "sys": {
                    "type": "Link",
                    "linkType": "User",
                    "id": "6i4t6xastbPBhgW7xDtpPH"
                }
            },
            "updatedBy": {
                "sys": {
                    "type": "Link",
                    "linkType": "User",
                    "id": "4RP9VsYx86a44lASXtinmi"
                }
            },
            "memberCount": 0
        }
    }]
}
```

### Get all teams for a space

[Get all teams for a space](/references/user-management-api/teams/get-all-teams-for-a-space)

This endpoint returns a paginated collection of all teams in this space.

All space members can access this endpoint.

#### Query Parameters

| Name            | Details | Description                                                                                         |
| --------------- | ------- | --------------------------------------------------------------------------------------------------- |
| `skip`, `limit` | -       | Specify requested page of result set. See [Pagination](#/introduction/pagination) for more details. |

#### Response

```js
{
    "total": 1,
    "limit": 25,
    "skip": 0,
    "sys": {
        "type": "Array"
    },
    "items": [{
        "name": "Home Department",
        "description": "Furniture and accessories",
        "sys": {
            "id": "2v0NGpymMx5dc1sWjtiarg",
            "type": "Team",
            "organization": {
                "sys": {
                    "type": "Link",
                    "linkType": "Organization",
                    "id": "4EJGvuLTBUMG2A6wS8gfAS"
                }
            },
            "createdAt": "2373-05-20T00:50:57.521Z",
            "updatedAt": "3882-12-12T21:02:17.948Z",
            "createdBy": {
                "sys": {
                    "type": "Link",
                    "linkType": "User",
                    "id": "6i4t6xastbPBhgW7xDtpPH"
                }
            },
            "updatedBy": {
                "sys": {
                    "type": "Link",
                    "linkType": "User",
                    "id": "4RP9VsYx86a44lASXtinmi"
                }
            },
            "memberCount": 0
        }
    }]
}
```

### Get a team

[Get a team](/references/user-management-api/teams/get-a-team)

This endpoint returns details about an existing team.

All organization members can access this endpoint.

#### Response

```js
{
    "name": "Home Department",
    "description": "Furniture and accessories",
    "sys": {
        "id": "2v0NGpymMx5dc1sWjtiarg",
        "type": "Team",
        "organization": {
            "sys": {
                "type": "Link",
                "linkType": "Organization",
                "id": "4EJGvuLTBUMG2A6wS8gfAS"
            }
        },
        "createdAt": "2373-05-20T00:50:57.521Z",
        "updatedAt": "3882-12-12T21:02:17.948Z",
        "createdBy": {
            "sys": {
                "type": "Link",
                "linkType": "User",
                "id": "6i4t6xastbPBhgW7xDtpPH"
            }
        },
        "updatedBy": {
            "sys": {
                "type": "Link",
                "linkType": "User",
                "id": "4RP9VsYx86a44lASXtinmi"
            }
        },
        "memberCount": 0
    }
}
```

### Create a team

[Create a team](/references/user-management-api/teams/create-a-team)

This endpoint creates a new team in this organization.

Only organization admins and owners can access this endpoint.

#### Request Body

| Parameter     | Type           | Usage    |
| ------------- | -------------- | -------- |
| `name`        | string         | required |
| `description` | string or null | required |

#### Response

```js
{
    "name": "Project Editors",
    "description": "",
    "sys": {
        "id": "7BslKh9TdKGOK41VmLDjFZ",
        "type": "Team",
        "organization": {
            "sys": {
                "type": "Link",
                "linkType": "Organization",
                "id": "4EJGvuLTBUMG2A6wS8gfAS"
            }
        },
        "createdAt": "4723-11-14T02:01:24.016Z",
        "updatedAt": "5087-06-17T18:24:44.837Z",
        "updatedBy": {
            "sys": {
                "type": "Link",
                "linkType": "User",
                "id": "7BslKh9TdKGOK41VmLDjFZ"
            }
        },
        "createdBy": {
            "sys": {
                "type": "Link",
                "linkType": "User",
                "id": "7BslKh9TdKGOK41VmLDjFZ"
            }
        },
        "memberCount": 0
    }
}
```

### Update a team

[Update a team](/references/user-management-api/teams/update-a-team)

This endpoint updates the data associated with a team.

Only organization admins and owners can access this endpoint.

#### Request Body

| Parameter     | Type           | Usage    |
| ------------- | -------------- | -------- |
| `name`        | string         | required |
| `description` | string or null | required |

#### Response

```js
{
    "name": "Project Editors",
    "description": "",
    "sys": {
        "id": "7BslKh9TdKGOK41VmLDjFZ",
        "type": "Team",
        "organization": {
            "sys": {
                "type": "Link",
                "linkType": "Organization",
                "id": "4EJGvuLTBUMG2A6wS8gfAS"
            }
        },
        "createdAt": "4723-11-14T02:01:24.016Z",
        "updatedAt": "5087-06-17T18:24:44.837Z",
        "updatedBy": {
            "sys": {
                "type": "Link",
                "linkType": "User",
                "id": "7BslKh9TdKGOK41VmLDjFZ"
            }
        },
        "createdBy": {
            "sys": {
                "type": "Link",
                "linkType": "User",
                "id": "7BslKh9TdKGOK41VmLDjFZ"
            }
        },
        "memberCount": 0
    }
}
```

### Delete a team

[Delete a team](/references/user-management-api/teams/delete-a-team)

This endpoint deletes a team.

Only organization admins and owners can access this endpoint.

#### Response

```headers
Status: 204 No Content
```


## API Docs

- Teams [Get all teams for an organization](https://contentful.com/developers/docs/references/user-management-api/teams/get-all-teams-for-an-organization.md)
- Teams [Create a team](https://contentful.com/developers/docs/references/user-management-api/teams/create-a-team.md)
- Teams [Get all teams for a space](https://contentful.com/developers/docs/references/user-management-api/teams/get-all-teams-for-a-space.md)
- Teams [Get a team](https://contentful.com/developers/docs/references/user-management-api/teams/get-a-team.md)
- Teams [Update a team](https://contentful.com/developers/docs/references/user-management-api/teams/update-a-team.md)
- Teams [Delete a team](https://contentful.com/developers/docs/references/user-management-api/teams/delete-a-team.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://contentful.com/developers/docs/openapi.json)
- [OpenAPI YAML](https://contentful.com/developers/docs/openapi.yaml)