Skip to main content
GET
Go (SDK)

Authorizations

Authorization
string
header
required

Send Authorization: Bearer , using an MKA1 API key for automation or an OAuth API access token for a signed-in application. Use a dynamic security callback to refresh OAuth access tokens. Browser session-only operations still require their declared cookie.

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