Skip to main content
GET
/
api
/
v1
/
llm
/
prompts
/
{id}
Python (SDK)
from mka1 import SDK


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

    res = sdk.llm.prompts.get(id="prompt_aa87e2b1112a455b8deabed784372198")

    # Handle response
    print(res)
{
  "id": "prompt_aa87e2b1112a455b8deabed784372198",
  "object": "prompt",
  "name": "Customer Support Classifier",
  "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",
  "active_template": "Classify the following customer message into one of these categories: {{categories}}\n\nMessage: {{message}}"
}

Documentation Index

Fetch the complete documentation index at: https://docs.mka1.com/llms.txt

Use this file to discover all available pages before exploring further.

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

Query Parameters

​
version
integer

Version to retrieve — defaults to active version

Required range: -9007199254740991 <= x <= 9007199254740991
​
variables
string

JSON-encoded key-value map to render into the template, e.g. {"name":"Alice"}

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

​
active_template
string
required

The template text for the requested version

​
description
string

Detailed description of the prompt

​
rendered_template
string

The template with variables substituted — only present when variables are provided