Endpoints

Users

Copy page

Operations for managing users

Create Nango Connect Session

POST
/work-apps/slack/users/connect

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

Request Body

application/json

tenantId?string

Tenant ID

userEmail?string

User email

userId*string

Inkeep user ID

userName?string

User display name

Response Body

application/json

curl -X POST "https://api.pilot.inkeep.com/work-apps/slack/users/connect" \  -H "Content-Type: application/json" \  -d '{    "userId": "string"  }'
{
  "connectUrl": "string",
  "sessionToken": "string"
}
Empty
Empty

Disconnect User

POST
/work-apps/slack/users/disconnect

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

Request Body

application/json

slackTeamId?string

Slack team ID

slackUserId?string

Slack user ID

tenantId?string

Tenant ID

userId?string

Inkeep user ID

Response Body

application/json

curl -X POST "https://api.pilot.inkeep.com/work-apps/slack/users/disconnect" \  -H "Content-Type: application/json" \  -d '{}'
{
  "success": true
}
Empty
Empty
Empty
GET
/work-apps/slack/users/link-status

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

Query Parameters

slackUserId*string
slackTeamId*string
tenantId?string
Default"default"

Response Body

application/json

curl -X GET "https://api.pilot.inkeep.com/work-apps/slack/users/link-status?slackUserId=string&slackTeamId=string"
{
  "linkId": "string",
  "linked": true,
  "linkedAt": "string",
  "slackUsername": "string"
}
POST
/work-apps/slack/users/link/verify-token

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

Request Body

application/json

token*string
Length1 <= length
userEmail?string
Formatemail
userId*string
Length1 <= length

Response Body

application/json

curl -X POST "https://api.pilot.inkeep.com/work-apps/slack/users/link/verify-token" \  -H "Content-Type: application/json" \  -d '{    "token": "string",    "userId": "string"  }'
{
  "linkId": "string",
  "slackTeamId": "string",
  "slackUsername": "string",
  "success": true,
  "tenantId": "string"
}
Empty
Empty

Get Connection Status

GET
/work-apps/slack/users/status

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

Query Parameters

userId*string

Inkeep user ID

Response Body

application/json

curl -X GET "https://api.pilot.inkeep.com/work-apps/slack/users/status?userId=string"
{
  "connected": true,
  "connection": {
    "appUserEmail": "string",
    "appUserId": "string",
    "connectionId": "string",
    "linkedAt": "string",
    "slackDisplayName": "string",
    "slackTeamId": "string",
    "slackUserId": "string",
    "tenantId": "string"
  }
}
Empty
Empty

List Linked Users

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

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

Response Body

application/json

curl -X GET "https://api.pilot.inkeep.com/work-apps/slack/workspaces/:teamId/users"
{
  "linkedUsers": [
    {
      "id": "string",
      "lastUsedAt": "string",
      "linkedAt": "string",
      "slackEmail": "string",
      "slackTeamId": "string",
      "slackUserId": "string",
      "slackUsername": "string",
      "userId": "string"
    }
  ]
}

User Project Memberships

Operations for managing user project memberships

Webhooks

Webhook endpoints