Skip to main content
PUT
/
api
/
v1
/
llm
/
prompts
/
{id}
Typescript (SDK)
import { SDK } from "@meetkai/mka1";

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

async function run() {
  const result = await sdk.llm.prompts.update({
    id: "prompt_aa87e2b1112a455b8deabed784372198",
    requestBody: {
      name: "Customer Support Classifier v2",
    },
  });

  console.log(result);
}

run();
{
  "id": "prompt_aa87e2b1112a455b8deabed784372198",
  "object": "prompt",
  "name": "Customer Support Classifier v2",
  "description": "Classifies incoming customer messages by intent",
  "active_version": 1,
  "latest_version": 1,
  "metadata": {},
  "created_at": "2026-03-15T10:30:00Z",
  "updated_at": "2026-03-15T10:30:00Z"
}

Authorizations

Authorization
string
header
required

Gateway auth: send Authorization: Bearer <mka1-api-key>. For multi-user server-side integrations, you can also send X-On-Behalf-Of: <external-user-id>.

Path Parameters

id
string
required

Prompt identifier

Body

application/json
name
string

Updated prompt name

Required string length: 1 - 255
description
string | null

Updated description — pass null to clear

Maximum string length: 2000
metadata
object

Updated metadata — replaces existing

Response

200 - application/json

OK

id
string
required

Unique prompt identifier

object
any
required

Object type

name
string
required

Human-readable prompt name

active_version
integer
required

Currently active version number

Required range: -9007199254740991 <= x <= 9007199254740991
latest_version
integer
required

Most recent version number

Required range: -9007199254740991 <= x <= 9007199254740991
metadata
object
required

Custom metadata key-value pairs

created_at
string<date-time>
required

Timestamp when the prompt was created

updated_at
string<date-time>
required

Timestamp when the prompt was last updated

description
string

Detailed description of the prompt