Create a chatbot. The secret key is returned ONCE.

POST /chatbots

Create a chatbot. The secret key is returned ONCE.

cURL

curl --request POST \
  --url https://api.pineyard.ai/chatbots \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "systemPrompt": "<string>"
}
'

201

{
  "id": "<string>",
  "name": "<string>",
  "systemPrompt": "<string>",
  "model": "<string>",
  "status": "<string>",
  "temperature": 123,
  "maxOutputTokens": 123,
  "rateLimitPerMinute": 123,
  "secretKeyLast4": "<string>",
  "knowledgeBaseIds": [
    "<string>"
  ],
  "createdAt": "<string>",
  "updatedAt": "<string>",
  "secret": "<string>"
}

Required scope: chatbots.edit

Requires chatbots enabled on your account. Otherwise the request is refused; see Errors.

Authorizations

Authorization · string · header · required

Your API key, e.g. pk_live_xxxxxxxxxxxxxxxxxxxxxxxx.

Body

application/json

name · string · required

Required string length: 1 - 120

systemPrompt · string · required

Required string length: 1 - 20000

model · string | null

Required string length: 1 - 120

temperature · number | null

Required range: 0 <= x <= 2

maxOutputTokens · integer | null

Required range: 64 <= x <= 8192

rateLimitPerMinute · integer

Required range: 1 <= x <= 10000

knowledgeBaseIds · string[]

Maximum array length: 50

Minimum string length: 1

Response

201

application/json

Created

id · string · required

name · string · required

systemPrompt · string · required

model · string | null · required

status · string · required

temperature · number | null · required

maxOutputTokens · number | null · required

rateLimitPerMinute · number · required

secretKeyLast4 · string · required

knowledgeBaseIds · string[] · required

createdAt · string · required

updatedAt · string · required

secret · string · required