---
title: "Invoke a SkillServer ability"
method: POST
path: "/integration/skillserver/{skillserverIntegrationId}/invoke"
tags: ["SkillServer Integration"]
---

# Invoke a SkillServer ability

`POST /integration/skillserver/{skillserverIntegrationId}/invoke`

## Request

- Base URL: `https://api.chatbotkit.com/api/v1`
- URL: `https://api.chatbotkit.com/api/v1/integration/skillserver/{skillserverIntegrationId}/invoke`
- Auth: `bearerAuth` (a scheme the document does not define)

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.

## Path parameters

- `skillserverIntegrationId` string, required: The ID of the SkillServer integration

## Query parameters

- `format` 'json': Set to "json" to receive a JSON response
- `session` string: Optional session id to group tool state across calls

## Request body

- object
  - `ability` string, required: The name of the ability to invoke (as listed in the manual)
  - `input` object: The ability input

## Response `200`

The ability was invoked

- object
  - `result` unknown
  - `error` string, nullable

## Other responses

- `default`: An error response

---

[API](https://skmtc.dev/chatbotkit/apis/cbk-api.md) · [All operations](https://skmtc.dev/chatbotkit/apis/cbk-api/llms.txt) · [OpenAPI document](https://skmtc.dev/chatbotkit/apis/cbk-api/revisions/13d250576136?raw)