Workspaces
Copy page
Operations for managing Slack workspaces
List Workspaces
Authorization
bearerAuth cookieAuth Bearer token authentication. Use this for API clients and service-to-service communication. Set the Authorization header to "Bearer ".
In: header
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
Response Body
application/json
curl -X GET "https://api.pilot.inkeep.com/work-apps/slack/workspaces"{
"workspaces": [
{
"connectionId": "string",
"defaultAgentName": "string",
"hasDefaultAgent": true,
"teamId": "string",
"teamName": "string",
"tenantId": "string"
}
]
}Get Workspace
Authorization
bearerAuth cookieAuth Bearer token authentication. Use this for API clients and service-to-service communication. Set the Authorization header to "Bearer ".
In: header
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
Response Body
application/json
curl -X GET "https://api.pilot.inkeep.com/work-apps/slack/workspaces/:teamId"{
"connectionId": "string",
"defaultAgent": {
"agentId": "string",
"agentName": "string",
"projectId": "string",
"projectName": "string"
},
"teamId": "string",
"teamName": "string",
"tenantId": "string"
}Uninstall Workspace
Authorization
bearerAuth cookieAuth Bearer token authentication. Use this for API clients and service-to-service communication. Set the Authorization header to "Bearer ".
In: header
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
Response Body
application/json
curl -X DELETE "https://api.pilot.inkeep.com/work-apps/slack/workspaces/:teamId"{
"success": true
}Check Workspace Health
Authorization
bearerAuth cookieAuth Bearer token authentication. Use this for API clients and service-to-service communication. Set the Authorization header to "Bearer ".
In: header
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
Response Body
application/json
curl -X GET "https://api.pilot.inkeep.com/work-apps/slack/workspaces/:teamId/health"{
"botId": "string",
"botName": "string",
"error": "string",
"healthy": true,
"permissions": {
"canPostMessages": true,
"canReadChannels": true,
"canReadHistory": true
},
"teamId": "string",
"teamName": "string"
}Get Workspace Settings
Authorization
bearerAuth cookieAuth Bearer token authentication. Use this for API clients and service-to-service communication. Set the Authorization header to "Bearer ".
In: header
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
Response Body
application/json
curl -X GET "https://api.pilot.inkeep.com/work-apps/slack/workspaces/:teamId/settings"{
"defaultAgent": {
"agentId": "string",
"agentName": "string",
"projectId": "string",
"projectName": "string"
}
}Update Workspace Settings
Authorization
bearerAuth cookieAuth Bearer token authentication. Use this for API clients and service-to-service communication. Set the Authorization header to "Bearer ".
In: header
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
Request Body
application/json
Response Body
application/json
application/json
curl -X PUT "https://api.pilot.inkeep.com/work-apps/slack/workspaces/:teamId/settings" \ -H "Content-Type: application/json" \ -d '{}'{
"success": true
}{
"success": true
}Send Test Message
Authorization
bearerAuth cookieAuth Bearer token authentication. Use this for API clients and service-to-service communication. Set the Authorization header to "Bearer ".
In: header
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
Request Body
application/json
Response Body
application/json
curl -X POST "https://api.pilot.inkeep.com/work-apps/slack/workspaces/:teamId/test-message" \ -H "Content-Type: application/json" \ -d '{ "channelId": "string" }'{
"error": "string",
"messageTs": "string",
"success": true
}