Create a bot instance
caution
The API has been deprecated and will be completely unavailable in the near future.
The API is deprecated due to the introduction of Strategy's new Auto Agent technology, which replaces the legacy Auto Bot system. Legacy Auto Bot support will be gradually discontinued after Strategy One (September 2025).
This workflow sample demonstrates how to create a bot instance.
info
Obtain the authorization token needed to execute the request using POST /api/auth/login.
Create a bot instance
Endpoint: POST /api/bots/{botId}/instances
note
Replace {botId}
in POST /api/bots/{botId}/instances
with the chatbot ID in your environment.
Sample Request Header:
"X-MSTR-AuthToken": "evvk84kcucn8abon6c1qfbud7"
"X-MSTR-ProjectID": "B7CA92F04B9FAE8D941C3E9B7E0CD754"
Sample Request Body:
{
"context": {
"type": "new"
}
}
Sample Curl:
curl 'https://demo.microstrategy.com/MicroStrategyLibrary/api/bots/6C6D314E4C881C01BFD79084DD5B2D42/instances' \
-X 'POST'
--header 'X-MSTR-AuthToken: t40ltbk411923ipk85r8r0tace' \
--header 'X-MSTR-ProjectID: FCC1924411EAABC39C6C0080EFA54501' \
--header 'Content-Type: application/json' \
--data '{
"context": {
"type": "new"
}
}'
Sample Response:
Response Code | Status |
---|---|
200 | Successfully create the bot instance |
400 | Error in creating the bot isntance |
401 | Authorization failed |
404 | Bot does not exist |
Sample Response Body on success:
{
"id": "5B1EB48585F04384A97F3D831D7C7416"
}