Inbox teams

Lists all teams for a chatbot

get

Required Permission: chatbots.teams.list

Resource: chatbots/:chatbotId

Authorizations

x-chatcaptain-key

x-chatcaptain-keystringRequired

Path parameters

chatbotIdstringRequired

The ID of the chatbot.

Responses

200

List of all teams.

application/json

errorstringOptional

Optional error message.

403

Insufficient permissions.

get

/v1/inbox/{chatbotId}/teams

HTTPcURLJavaScriptPython

GET /v1/inbox/{chatbotId}/teams HTTP/1.1
Host: api.chatcaptain.com
x-chatcaptain-key: YOUR_API_KEY
Accept: */*

{
  "teams": [
    {
      "id": "L1SQSnEeYL61pMtEKDln",
      "name": "First-Level-Support",
      "created": "2025-10-07T10:00:00Z",
      "updated": "2025-10-07T10:05:00Z",
      "icon": "support_agent",
      "userIds": [
        "uaYAdkVQteacOnKtQMhX"
      ]
    }
  ],
  "error": "text"
}

Creates a new team

post

Required Permission: chatbots.teams.create

Resource: chatbots/:chatbotId

Authorizations

x-chatcaptain-key

x-chatcaptain-keystringRequired

Path parameters

chatbotIdstringRequired

The ID of the chatbot.

Body

application/json

namestringRequired

The name of the new team.

Example: Customer Service Team

Responses

201

Team created successfully.

application/json

400

Invalid input data.

403

Insufficient permissions.

post

/v1/inbox/{chatbotId}/teams

HTTPcURLJavaScriptPython

POST /v1/inbox/{chatbotId}/teams HTTP/1.1
Host: api.chatcaptain.com
x-chatcaptain-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 32

{
  "name": "Customer Service Team"
}

{
  "team": {
    "id": "L1SQSnEeYL61pMtEKDln",
    "name": "First-Level-Support",
    "created": "2025-10-07T10:00:00Z",
    "updated": "2025-10-07T10:05:00Z",
    "icon": "support_agent",
    "userIds": [
      "uaYAdkVQteacOnKtQMhX"
    ]
  },
  "error": "text"
}

Retrieves a specific team

get

Required Permission: chatbots.teams.get

Resource: chatbots/:chatbotId

Authorizations

x-chatcaptain-key

x-chatcaptain-keystringRequired

Path parameters

chatbotIdstringRequired

The ID of the chatbot.

teamIdstringRequired

The ID of the team to retrieve.

Responses

200

Details of the team.

application/json

errorstringOptional

Optional error message.

403

Insufficient permissions.

get

/v1/inbox/{chatbotId}/teams/{teamId}

HTTPcURLJavaScriptPython

GET /v1/inbox/{chatbotId}/teams/{teamId} HTTP/1.1
Host: api.chatcaptain.com
x-chatcaptain-key: YOUR_API_KEY
Accept: */*

{
  "team": {
    "id": "L1SQSnEeYL61pMtEKDln",
    "name": "First-Level-Support",
    "created": "2025-10-07T10:00:00Z",
    "updated": "2025-10-07T10:05:00Z",
    "icon": "support_agent",
    "userIds": [
      "uaYAdkVQteacOnKtQMhX"
    ]
  },
  "error": "text"
}

Deletes a team

delete

Required Permission: chatbots.teams.delete

Resource: chatbots/:chatbotId

Authorizations

x-chatcaptain-key

x-chatcaptain-keystringRequired

Path parameters

chatbotIdstringRequired

The ID of the chatbot.

teamIdstringRequired

The ID of the team to delete.

Responses

200

Team deleted successfully.

No content

403

Insufficient permissions.

delete

/v1/inbox/{chatbotId}/teams/{teamId}

HTTPcURLJavaScriptPython

DELETE /v1/inbox/{chatbotId}/teams/{teamId} HTTP/1.1
Host: api.chatcaptain.com
x-chatcaptain-key: YOUR_API_KEY
Accept: */*

No content

Updates an existing team

patch

Required Permission: chatbots.teams.edit

Resource: chatbots/:chatbotId

Authorizations

x-chatcaptain-key

x-chatcaptain-keystringRequired

Path parameters

chatbotIdstringRequired

The ID of the chatbot.

teamIdstringRequired

The ID of the team to update.

Body

application/json

Responses

200

Team updated successfully.

application/json

errorstringOptional

Optional error message.

400

Invalid input data.

403

Insufficient permissions.

patch

/v1/inbox/{chatbotId}/teams/{teamId}

HTTPcURLJavaScriptPython

PATCH /v1/inbox/{chatbotId}/teams/{teamId} HTTP/1.1
Host: api.chatcaptain.com
x-chatcaptain-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 101

{
  "updated": {
    "userIds": [
      "ZVfFkkOEuHzYWaSijjNk",
      "SfHdrGq4Yosu5QeHYXVp"
    ],
    "name": "Second-Level-Support"
  }
}

{
  "team": {
    "id": "L1SQSnEeYL61pMtEKDln",
    "name": "First-Level-Support",
    "created": "2025-10-07T10:00:00Z",
    "updated": "2025-10-07T10:05:00Z",
    "icon": "support_agent",
    "userIds": [
      "uaYAdkVQteacOnKtQMhX"
    ]
  },
  "error": "text"
}