Endpoints

Channels

Copy page

Operations for managing Slack channels

List Channels

GET
/work-apps/slack/workspaces/:teamId/channels

Authorization

bearerAuth cookieAuth
AuthorizationBearer <token>

Bearer token authentication. Use this for API clients and service-to-service communication. Set the Authorization header to "Bearer ".

In: header

better-auth.session_token<token>

Session-based authentication using HTTP-only cookies. Cookies are automatically sent by browsers. For server-side requests, include cookies with names starting with "better-auth." in the Cookie header.

In: cookie

Path Parameters

teamId*string

Query Parameters

limit?number
Default100
cursor?string
types?string

Response Body

application/json

curl -X GET "https://api.pilot.inkeep.com/work-apps/slack/workspaces/:teamId/channels"
{
  "channels": [
    {
      "agentConfig": {
        "agentId": "string",
        "agentName": "string",
        "projectId": "string",
        "projectName": "string"
      },
      "hasAgentConfig": true,
      "id": "string",
      "isPrivate": true,
      "isShared": true,
      "memberCount": 0,
      "name": "string"
    }
  ],
  "nextCursor": "string"
}
Empty

Get Channel Settings

GET
/work-apps/slack/workspaces/:teamId/channels/:channelId/settings

Authorization

bearerAuth cookieAuth
AuthorizationBearer <token>

Bearer token authentication. Use this for API clients and service-to-service communication. Set the Authorization header to "Bearer ".

In: header

better-auth.session_token<token>

Session-based authentication using HTTP-only cookies. Cookies are automatically sent by browsers. For server-side requests, include cookies with names starting with "better-auth." in the Cookie header.

In: cookie

Path Parameters

teamId*string
channelId*string

Response Body

application/json

curl -X GET "https://api.pilot.inkeep.com/work-apps/slack/workspaces/:teamId/channels/:channelId/settings"
{
  "agentConfig": {
    "agentId": "string",
    "agentName": "string",
    "projectId": "string",
    "projectName": "string"
  },
  "channelId": "string"
}

Remove Channel Config

DELETE
/work-apps/slack/workspaces/:teamId/channels/:channelId/settings

Authorization

bearerAuth cookieAuth
AuthorizationBearer <token>

Bearer token authentication. Use this for API clients and service-to-service communication. Set the Authorization header to "Bearer ".

In: header

better-auth.session_token<token>

Session-based authentication using HTTP-only cookies. Cookies are automatically sent by browsers. For server-side requests, include cookies with names starting with "better-auth." in the Cookie header.

In: cookie

Path Parameters

teamId*string
channelId*string

Response Body

application/json

curl -X DELETE "https://api.pilot.inkeep.com/work-apps/slack/workspaces/:teamId/channels/:channelId/settings"
{
  "success": true
}

Set Channel Default Agent

PUT
/work-apps/slack/workspaces/:teamId/channels/:channelId/settings

Authorization

bearerAuth cookieAuth
AuthorizationBearer <token>

Bearer token authentication. Use this for API clients and service-to-service communication. Set the Authorization header to "Bearer ".

In: header

better-auth.session_token<token>

Session-based authentication using HTTP-only cookies. Cookies are automatically sent by browsers. For server-side requests, include cookies with names starting with "better-auth." in the Cookie header.

In: cookie

Path Parameters

teamId*string
channelId*string

Request Body

application/json

agentConfig*
channelName?string
channelType?string

Response Body

application/json

curl -X PUT "https://api.pilot.inkeep.com/work-apps/slack/workspaces/:teamId/channels/:channelId/settings" \  -H "Content-Type: application/json" \  -d '{    "agentConfig": {      "agentId": "string",      "projectId": "string"    }  }'
{
  "configId": "string",
  "success": true
}

Bulk Remove Channel Configs

DELETE
/work-apps/slack/workspaces/:teamId/channels/bulk

Authorization

bearerAuth cookieAuth
AuthorizationBearer <token>

Bearer token authentication. Use this for API clients and service-to-service communication. Set the Authorization header to "Bearer ".

In: header

better-auth.session_token<token>

Session-based authentication using HTTP-only cookies. Cookies are automatically sent by browsers. For server-side requests, include cookies with names starting with "better-auth." in the Cookie header.

In: cookie

Path Parameters

teamId*string

Request Body

application/json

channelIds*array<>
Items1 <= items

Response Body

application/json

curl -X DELETE "https://api.pilot.inkeep.com/work-apps/slack/workspaces/:teamId/channels/bulk" \  -H "Content-Type: application/json" \  -d '{    "channelIds": [      "string"    ]  }'
{
  "removed": 0,
  "success": true
}

Bulk Set Channel Agents

PUT
/work-apps/slack/workspaces/:teamId/channels/bulk

Authorization

bearerAuth cookieAuth
AuthorizationBearer <token>

Bearer token authentication. Use this for API clients and service-to-service communication. Set the Authorization header to "Bearer ".

In: header

better-auth.session_token<token>

Session-based authentication using HTTP-only cookies. Cookies are automatically sent by browsers. For server-side requests, include cookies with names starting with "better-auth." in the Cookie header.

In: cookie

Path Parameters

teamId*string

Request Body

application/json

agentConfig*
channelIds*array<>
Items1 <= items

Response Body

application/json

curl -X PUT "https://api.pilot.inkeep.com/work-apps/slack/workspaces/:teamId/channels/bulk" \  -H "Content-Type: application/json" \  -d '{    "agentConfig": {      "agentId": "string",      "projectId": "string"    },    "channelIds": [      "string"    ]  }'
{
  "errors": [
    {
      "channelId": "string",
      "error": "string"
    }
  ],
  "failed": 0,
  "success": true,
  "updated": 0
}
Empty
Empty