Skip to main content
POST
/
api
/
v1
/
search
/
text-store
/
stores
/
{store_name}
/
texts
Typescript (SDK)
import { SDK } from "@meetkai/mka1";

const sdk = new SDK({
  bearerAuth: "<YOUR_BEARER_TOKEN_HERE>",
});

async function run() {
  const result = await sdk.search.textStore.addTexts({
    storeName: "<value>",
    xApiKeyId: "<id>",
    xUserId: "<id>",
    xExchangeJwtExternalUserId: "<id>",
    addTextsRequest: {
      texts: [
        "Wireless noise-cancelling headphones with 30-hour battery life",
        "USB-C charging cable with braided nylon sleeve",
        "Portable 65W GaN wall charger with two USB-C ports",
      ],
      vectors: [
        [
          0.14,
          -0.07,
          0.31,
        ],
        [
          0.19,
          -0.11,
          0.27,
        ],
        [
          0.09,
          -0.04,
          0.22,
        ],
      ],
      group: "electronics_q1_2026",
    },
  });

  console.log(result);
}

run();
{
  "added_count": 3,
  "message": "Successfully added 3 texts (skipped 0 duplicates)",
  "skipped_count": 0
}

Authorizations

Authorization
string
header
required

Authenticate with your MKA1 API key at the API gateway: Authorization: Bearer <mka1-api-key>. For multi-user server-side integrations, also send X-On-Behalf-Of to identify the end user making the request.

Headers

X-On-Behalf-Of
string

Optional external user identifier for multi-user server-side integrations. Use this when acting on behalf of one of your end users.

x-api-key-id
string
required
x-user-id
string
required
x-exchange-jwt-external-user-id
string
required

Path Parameters

store_name
string
required

Body

application/json

Request to add texts to a store.

texts
string[]
required

List of text strings to add

Minimum array length: 1
vectors
number[][]
required

Embedding vectors corresponding to each text

Minimum array length: 1
group
string
required

Group identifier for these texts

Minimum string length: 1

Response

Successful Response

Response after adding texts.

added_count
integer
required

Number of new texts inserted

skipped_count
integer
required

Number of texts skipped as duplicates

message
string
required

Operation status message