Update a prompt

Updates prompt metadata. To update the template content, create a new version instead.

PUT /api/v1/llm/prompts/{id}

Python (SDK)

Python

from mka1 import SDK


with SDK(
    bearer_auth="<YOUR_BEARER_TOKEN_HERE>",
) as sdk:

    res = sdk.llm.prompts.update(id="prompt_aa87e2b1112a455b8deabed784372198", name="Customer Support Classifier v2")

    # Handle response
    print(res)

200

{
  "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>.

Headers

X-On-Behalf-Of · string

Optional external end-user identifier forwarded by the API gateway.

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

Show child attributes

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

Show child attributes

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