Create a new version

Creates a new version of a prompt. The new version automatically becomes the active version. Fields not provided are carried forward from the previous version.

POST /api/v1/llm/prompts/{id}/versions

Python (SDK)

Python

from mka1 import SDK


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

    res = sdk.llm.prompts.create_version(id="prompt_aa87e2b1112a455b8deabed784372198", template="You are a customer support classifier. Classify the message into: {{categories}}\n\nRespond with only the category name.\n\nMessage: {{message}}")

    # Handle response
    print(res)

201

{
  "id": "pver_bb98f3c2223b566c9dfbcef895483209",
  "prompt_id": "prompt_aa87e2b1112a455b8deabed784372198",
  "version": 2,
  "object": "prompt.version",
  "template": "Classify the following customer message into one of these categories: {{categories}}\n\nMessage: {{message}}",
  "created_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

Parent prompt identifier

Body

application/json

template · string · required

The prompt template text

Required string length: 1 - 100000

Response

201 - application/json

OK

id · string · required

Unique version identifier

prompt_id · string · required

Parent prompt identifier

version · integer · required

Version number

Required range: -9007199254740991 <= x <= 9007199254740991

object · any · required

Object type

template · string · required

The prompt template text with {{variable}} placeholders

created_at · string<date-time> · required

Timestamp when this version was created