# Teams

> List teams, manage team membership, add or remove members.

Language: en
Canonical: https://www.dailybot.com/developers/api/teams
Markdown: send header `Accept: text/markdown` on any URL to receive Markdown instead of HTML.
Last Updated: 2026-04-06

---

# Teams

List teams, manage team membership, and add or remove members.

## Endpoints summary

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `/v1/teams/` | List all teams |
| GET | `/v1/teams/{id}/` | Get a specific team |
| GET | `/v1/teams/{id}/members/` | Get team members |
| POST | `/v1/teams/{id}/members/` | Add a member to a team |
| DELETE | `/v1/teams/{id}/members/{user_id}/` | Remove a member from a team |
| GET | `/v1/teams/{id}/members/{user_id}/` | Get a specific team member |
| PATCH | `/v1/teams/{id}/members/{user_id}/` | Update a team member |

---

## GET /v1/teams/

Returns all teams in the organization.

### Query parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `limit` | integer | No | Number of results. Default: 250. |
| `offset` | integer | No | Pagination offset. |

```bash
curl -X GET "https://api.dailybot.com/v1/teams/" \
  -H "X-API-KEY: your_api_key"
```

**Response (200 OK):**

```json
{
  "count": 3,
  "results": [
    {
      "id": "team-uuid",
      "name": "Engineering",
      "description": "Core engineering team",
      "member_count": 8
    }
  ]
}
```

---

## GET /v1/teams/{id}/

Returns a specific team.

```bash
curl -X GET "https://api.dailybot.com/v1/teams/team-uuid/" \
  -H "X-API-KEY: your_api_key"
```

---

## GET /v1/teams/{id}/members/

Returns all members of a team.

```bash
curl -X GET "https://api.dailybot.com/v1/teams/team-uuid/members/" \
  -H "X-API-KEY: your_api_key"
```

**Response (200 OK):**

```json
{
  "count": 8,
  "results": [
    {
      "uuid": "usr_abc123",
      "name": "Jane Doe",
      "email": "jane@company.com",
      "role": "member"
    }
  ]
}
```

---

## POST /v1/teams/{id}/members/

Adds a user to a team.

### Body parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `user_uuid` | string (UUID) | Yes | UUID of the user to add. |
| `role` | string | No | Role within the team: `member` (default) or `lead`. |

```bash
curl -X POST "https://api.dailybot.com/v1/teams/team-uuid/members/" \
  -H "X-API-KEY: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"user_uuid": "usr_abc123", "role": "member"}'
```

**Response (201 Created):**

```json
{
  "uuid": "usr_abc123",
  "name": "Jane Doe",
  "role": "member"
}
```

---

## DELETE /v1/teams/{id}/members/{user_id}/

Removes a user from a team.

```bash
curl -X DELETE "https://api.dailybot.com/v1/teams/team-uuid/members/usr_abc123/" \
  -H "X-API-KEY: your_api_key"
```

**Response (204 No Content)**

## Endpoints in this group

List teams, retrieve members, and manage team membership programmatically.

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `/v1/teams/` | List teams |
| GET | `/v1/teams/{uuid}/` | Retrieve a team |
| GET | `/v1/teams/{team_uuid}/members/` | List members of a team |
| POST | `/v1/teams/{team_uuid}/member/` | Add a member to a team |
| GET | `/v1/teams/{team_uuid}/member/{user_uuid}/` | Retrieve a team member |
| PATCH | `/v1/teams/{team_uuid}/member/{user_uuid}/` | Update a team member |
| DELETE | `/v1/teams/{team_uuid}/member/{user_uuid}/` | Remove a team member |

### GET `/v1/teams/`

**List teams**

List teams

- **Auth:** API key (`X-API-KEY`), CLI Bearer (read)
- **Rate limit:** `default`
- **Pagination:** Page-number pagination

#### Error codes

| Status | When |
|--------|------|
| `401` | Missing/invalid/expired credential |
| `403` | Authenticated but not permitted |
| `429` | Throttled - Retry-After header set |

#### Example (curl)

```bash
curl -sS -X GET 'https://api.dailybot.com/v1/teams/' -H 'X-API-KEY: $DAILYBOT_API_KEY'
```

### GET `/v1/teams/{uuid}/`

**Retrieve a team**

Retrieve a team

- **Auth:** API key (`X-API-KEY`), CLI Bearer (read)
- **Rate limit:** `default`
- **Pagination:** No pagination

#### Path parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `uuid` | string (uuid) | Yes | — |

#### Error codes

| Status | When |
|--------|------|
| `401` | Missing/invalid/expired credential |
| `403` | Authenticated but not permitted |
| `429` | Throttled - Retry-After header set |
| `404` | Not found or not visible |

#### Example (curl)

```bash
curl -sS -X GET 'https://api.dailybot.com/v1/teams/{uuid}/' -H 'X-API-KEY: $DAILYBOT_API_KEY'
```

### GET `/v1/teams/{team_uuid}/members/`

**List members of a team**

List members of a team

- **Auth:** API key (`X-API-KEY`), CLI Bearer (read)
- **Rate limit:** `default`
- **Pagination:** No pagination

#### Path parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `team_uuid` | string (uuid) | Yes | — |

#### Error codes

| Status | When |
|--------|------|
| `401` | Missing/invalid/expired credential |
| `403` | Authenticated but not permitted |
| `429` | Throttled - Retry-After header set |

#### Example (curl)

```bash
curl -sS -X GET 'https://api.dailybot.com/v1/teams/{team_uuid}/members/' -H 'X-API-KEY: $DAILYBOT_API_KEY'
```

### POST `/v1/teams/{team_uuid}/member/`

**Add a member to a team**

Add a member to a team

- **Auth:** API key (`X-API-KEY`), CLI Bearer (write)
- **Rate limit:** `default`
- **Pagination:** No pagination

#### Path parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `team_uuid` | string (uuid) | Yes | — |

#### Error codes

| Status | When |
|--------|------|
| `401` | Missing/invalid/expired credential |
| `403` | Authenticated but not permitted |
| `429` | Throttled - Retry-After header set |
| `400` | Validation error |
| `404` | Not found or not visible |

#### Example (curl)

```bash
curl -sS -X POST 'https://api.dailybot.com/v1/teams/{team_uuid}/member/' -H 'X-API-KEY: $DAILYBOT_API_KEY'
```

### GET `/v1/teams/{team_uuid}/member/{user_uuid}/`

**Retrieve a team member**

Retrieve a team member

- **Auth:** API key (`X-API-KEY`), CLI Bearer (read)
- **Rate limit:** `default`
- **Pagination:** No pagination

#### Path parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `team_uuid` | string (uuid) | Yes | — |
| `user_uuid` | string (uuid) | Yes | — |

#### Error codes

| Status | When |
|--------|------|
| `401` | Missing/invalid/expired credential |
| `403` | Authenticated but not permitted |
| `429` | Throttled - Retry-After header set |
| `404` | Not found or not visible |

#### Example (curl)

```bash
curl -sS -X GET 'https://api.dailybot.com/v1/teams/{team_uuid}/member/{user_uuid}/' -H 'X-API-KEY: $DAILYBOT_API_KEY'
```

### PATCH `/v1/teams/{team_uuid}/member/{user_uuid}/`

**Update a team member**

Update a team member

- **Auth:** API key (`X-API-KEY`), CLI Bearer (write)
- **Rate limit:** `default`
- **Pagination:** No pagination

#### Path parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `team_uuid` | string (uuid) | Yes | — |
| `user_uuid` | string (uuid) | Yes | — |

#### Error codes

| Status | When |
|--------|------|
| `401` | Missing/invalid/expired credential |
| `403` | Authenticated but not permitted |
| `429` | Throttled - Retry-After header set |
| `400` | Validation error |
| `404` | Not found or not visible |

#### Example (curl)

```bash
curl -sS -X PATCH 'https://api.dailybot.com/v1/teams/{team_uuid}/member/{user_uuid}/' -H 'X-API-KEY: $DAILYBOT_API_KEY'
```

### DELETE `/v1/teams/{team_uuid}/member/{user_uuid}/`

**Remove a team member**

Remove a team member

- **Auth:** API key (`X-API-KEY`), CLI Bearer (write)
- **Rate limit:** `default`
- **Pagination:** No pagination

#### Path parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `team_uuid` | string (uuid) | Yes | — |
| `user_uuid` | string (uuid) | Yes | — |

#### Error codes

| Status | When |
|--------|------|
| `401` | Missing/invalid/expired credential |
| `403` | Authenticated but not permitted |
| `429` | Throttled - Retry-After header set |
| `404` | Not found or not visible |

#### Example (curl)

```bash
curl -sS -X DELETE 'https://api.dailybot.com/v1/teams/{team_uuid}/member/{user_uuid}/' -H 'X-API-KEY: $DAILYBOT_API_KEY'
```

---

## Developer portal navigation

**Getting Started**

- [Overview](/developers)
- [Quick start](/developers/getting-started)
- [Authentication](/developers/authentication)

**API Reference**

- [API Overview](/developers/api)
- [Users](/developers/api/users)
- [Organization](/developers/api/organization)
- [Teams](/developers/api/teams) (this page)
- [Invitations](/developers/api/invitations)
- [Check-ins](/developers/api/check-ins)
- [Forms](/developers/api/forms)
- [Report channels](/developers/api/report-channels)
- [Templates](/developers/api/templates)
- [Kudos](/developers/api/kudos)
- [Mood tracking](/developers/api/mood)
- [Important dates](/developers/api/important-dates)
- [Messaging](/developers/api/messaging)
- [Automations](/developers/api/workflows)
- [Webhooks](/developers/api/webhooks)
- [Commands platform](/developers/api/commands-platform)
- [Agents](/developers/api/agents)
- [OAuth2](/developers/api/oauth2)
- [Integrations](/developers/api/integrations)
- [CLI](/developers/api/cli)

**API guides**

- [Errors & Status Codes](/developers/errors)
- [Rate Limits](/developers/rate-limits)
- [Conventions](/developers/conventions)
- [API Changelog](/developers/api-changelog)
- [Recipes](/developers/recipes)

**Developer Features**

- [Custom commands](/developers/custom-commands)
- [Serverless commands](/developers/serverless)
- [Webhooks & events](/developers/webhooks)
- [Automation API trigger](/developers/workflow-trigger)
- [Activity API](/developers/activity-api)

**CLI**

- [Overview](/developers/cli)
- [Authentication](/developers/cli-authentication)
- [Command reference](/developers/cli-reference)
- [CI/CD recipes](/developers/cli-ci-cd)
- [Configuration](/developers/cli-configuration)
- [Troubleshooting](/developers/cli-troubleshooting)

**Agent Skill**

- [Overview](/developers/agent-skill)
- [Skills catalog](/skills)

---

## Site navigation

**Product:**
- [Home](/)
- [Product](/product)
- [Pricing](/pricing)
- [Enterprise](/enterprise)
- [Integrations](/integrations)
- [Templates](/templates)

**Resources:**
- [Blog](/blog)
- [Academy](/academy)
- [Changelog](/changelog)
- [Help Center](/help)
- [Developers](/developers)
- [Agents](/agents)

**Company:**
- [About](/about)
- [Careers](/careers)
- [Security](/security)
- [Contact Sales](/demo)

**Connect:**
- [LinkedIn](https://www.linkedin.com/company/dailybot/)
- [X/Twitter](https://twitter.com/dailybot)
- [GitHub](https://github.com/Dailybot-Inc)
- [YouTube](https://www.youtube.com/channel/UC3uM9V52vwX7e3vQpCc4qvA)