Teams

Teams group organization members for check-ins, messaging, and workflow management. Use these endpoints to list teams, view members, and manage team membership.

Method	Endpoint	Description
GET	/v1/teams/	List all teams
GET	/v1/teams/{team-uuid}/	Get a specific team
GET	/v1/teams/{team-uuid}/members/	Get team members
POST	/v1/teams/{team-uuid}/member/	Add a team member
DELETE	/v1/teams/{team-uuid}/member/{user-uuid}/	Remove a team member
GET	/v1/teams/{team-uuid}/member/{user-uuid}/	Get a team member
PATCH	/v1/teams/{team-uuid}/member/{user-uuid}/	Update a team member

List Teams

GET /v1/teams/

Returns all teams in the organization.

Request

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

Response 200 OK

json

[
  {
    "uuid": "team-uuid",
    "name": "Engineering",
    "active": true,
    "is_default": false
  }
]

Get Team

GET /v1/teams/{team-uuid}/

Returns a single team by UUID.

Request

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

Response 200 OK

json

{
  "uuid": "team-uuid",
  "name": "Engineering",
  "active": true,
  "is_default": false
}

Response 404 Not Found

json

{
  "detail": "Not found.",
  "code": "not_found"
}

Get Team Members

GET /v1/teams/{team-uuid}/members/

Returns the list of members in the team.

Request

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

Response 200 OK

json

[
  {
    "uuid": "user-uuid",
    "full_name": "Jane Smith",
    "image": "https://...",
    "role": "admin",
    "is_active": true,
    "bot_enabled": true,
    "timezone": "America/New_York",
    "occupation": "Designer",
    "birth_date": "02-08",
    "chat_platform_data": {},
    "work_days": [
      0,
      1,
      2,
      3,
      4
    ],
    "timeoff_start": null,
    "timeoff_end": null,
    "hour_init_work": "09:00",
    "anniversary": null,
    "organization": {
      "uuid": "org-uuid",
      "name": "Acme Corp"
    }
  }
]

Add Team Member

POST /v1/teams/{team-uuid}/member/

Adds members to a team.

Body Parameters

Name	Type	Required	Description
`members`	array	Required	List of member objects to add (structure defined by the API).

Request

curl -X POST "https://api.dailybot.com/v1/teams/team-uuid/member/" \
  -H "X-API-KEY: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "members": [
      { "uuid": "user-uuid" }
    ]
  }'

Response 200 OK

json

{
  "detail": "Users added to team successfully!"
}

Response 400 Bad Request

json

{
  "detail": "This team does not belong to your organization"
}

Remove Team Member

DELETE /v1/teams/{team-uuid}/member/{user-uuid}/

Removes a member from the team. At least one member must remain. Allowed for organization admins or team admins.

Request

curl -X DELETE "https://api.dailybot.com/v1/teams/team-uuid/member/user-uuid/" \
  -H "X-API-KEY: your_api_key"

Response 204 No Content

json

Response 400 Bad Request

json

{
  "detail": "This action is only allowed for organization admins or team admins"
}

Response 400 Bad Request (example 2)

json

{
  "detail": "There must be at least one team member"
}

Response 404 Not Found

json

{
  "detail": "Not found.",
  "code": "not_found"
}

Get Team Member

GET /v1/teams/{team-uuid}/member/{user-uuid}/

Returns a single team membership (role, user, team) by team UUID and user UUID. Use this when you need the membership role; use GET /v1/teams/{team-uuid}/members/{user-uuid}/ for full user profile.

Request

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

Response 200 OK

json

{
  "team": {
    "uuid": "team-uuid",
    "name": "Engineering",
    "active": true,
    "is_default": false
  },
  "user": {
    "uuid": "user-uuid",
    "full_name": "Jane Smith",
    "image": "...",
    "role": "member",
    "is_active": true
  },
  "role": "member"
}

Response 404 Not Found

json

{
  "detail": "Not found.",
  "code": "not_found"
}

Update Team Member

PATCH /v1/teams/{team-uuid}/member/{user-uuid}/

Updates a team member's role (e.g. set as team admin). Allowed for organization admins or team admins.

Body Parameters

Name	Type	Required	Description
`role`	string	Optional	New role. Allowed values: MEMBER, ADMIN_ORG, MANAGER.

Request

curl -X PATCH "https://api.dailybot.com/v1/teams/team-uuid/member/user-uuid/" \
  -H "X-API-KEY: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "role": "admin"
  }'

Response 200 OK

json

{
  "team": {
    "uuid": "team-uuid",
    "name": "Engineering",
    "active": true,
    "is_default": false
  },
  "user": {
    "uuid": "user-uuid",
    "full_name": "Jane Smith",
    "image": "...",
    "role": "admin",
    "is_active": true
  },
  "role": "admin"
}

Response 400 Bad Request

json

{
  "detail": "This action is only allowed for organization admins or team admins"
}

Response 404 Not Found

json

{
  "detail": "Not found.",
  "code": "not_found"
}