Assistants and models

In OpenAI's format, model names a language model. Here it is your assistant's ID and selects which assistant replies. Its Sonecentral settings determine the language model, instructions and tools; requests cannot change them.

What the assistant usesCopy Anchor Link

The API assistant is the same assistant that replies on WhatsApp, Instagram and Messenger. It uses your workspace configuration in the same way:

• Services, with prices, durations, images and links.
• Products and stock, with prices, images and links.
• Catalog items and packages.
• Team, departments and business hours.
• Business name, address and phone number.
• Your connected store's shipping rules and campaigns.
• Price lists and any configured discount authority.
• Knowledge Base documents, documents marked as shareable, and business data extracted from your documents.
• Order and appointment requests and appointment availability, if the key enables requests.
• Notes for the team and conversation handoff.

Product and service cards, buttons and files arrive as structured data: Rich messages.

Because API visitors are not authenticated, the assistant does not read or change their personal records (previous orders, existing appointments, customer profile, remembered information or connected panel account), and does not confirm appointments itself. See Orders, appointments and privacy.

List assistantsCopy Anchor Link

curl https://pb.sonecentral.com/api/v1/models \
  -H "Authorization: Bearer $SONE_API_KEY"

{
  "object": "list",
  "data": [
    {
      "id": "k3m9x2p7q1w8e4r",
      "object": "model",
      "created": 1760889600,
      "owned_by": "sonecentral",
      "name": "Store assistant"
    }
  ]
}

The list contains only published assistants the key can call. Drafts and assistants with incomplete setup are excluded. Results are sorted by assistant name.

GET /models/{id} returns the same object for one assistant.

curl https://pb.sonecentral.com/api/v1/models/k3m9x2p7q1w8e4r \
  -H "Authorization: Bearer $SONE_API_KEY"

In OpenAI SDKs, use client.models.list() and client.models.retrieve(id).

Everything before the final / in model is ignored. Tools that prefix model names with a provider can therefore use sonecentral/k3m9x2p7q1w8e4r to select the same assistant.

"default"Copy Anchor Link

When model is omitted or set to "default", selection follows this order:

1. The key's only allowed assistant, if there is exactly one.
2. Otherwise, the workspace's default text assistant, if the key allows it.
3. Otherwise, the first allowed assistant in alphabetical name order.

If your key allows several assistants and the choice matters, send an explicit ID.

Conversation and assistantCopy Anchor Link

A conversation is bound to the assistant that started it. Continuing it with another model returns 400 conversation_model_mismatch. Use the same assistant or start a new conversation.

ErrorsCopy Anchor Link