SkillServer Integrations

Invoke Skill Server Ability

Invoke a SkillServer ability

post
/v1/integration/skillserver/{skillserverIntegrationId}/invoke

Description

Directly invoke a single ability from the linked skillset by name. Authenticated with the static access token as a bearer token. Responses are plain text by default; append ?format=json (or send an Accept: application/json header) for a JSON response.

Authorization

ChatBotKit API Secret * Required

HTTP Authorization Scheme: bearer

Path Parameters

skillserverIntegrationIdstring* Required

The ID of the SkillServer integration

formatstring

Set to "json" to receive a JSON response

sessionstring

Optional session id to group tool state across calls

Request Body * Required

Request Body Schema: application/json

abilitystring

The name of the ability to invoke (as listed in the manual)

inputobject

The ability input

import { ChatBotKit } from '@chatbotkit/sdk'

const cbk = new ChatBotKit({

secret: process.env.CHATBOTKIT_API_KEY!

})

const response = await cbk.integration.skillserver.invoke(

skillserverIntegrationId,
{
"ability":"string",
"input":"object"
}
)
{
"result":"",
"error":"string"
}
The ability was invoked