Pular para o conteúdo principal
PUT
/
api
/
v1
/
llm
/
prompts
/
{id}
Python (SDK)
from openapi 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)
{
  "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"
}

Autorizações

Authorization
string
header
obrigatório

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

Parâmetros de caminho

id
string
obrigatório

Identificador do prompt

Corpo

application/json
name
string

Nome do prompt atualizado

Required string length: 1 - 255
description
string | null

Descrição atualizada — passe nulo para limpar

Maximum string length: 2000
metadata
object

Metadados atualizados — substitui os existentes

Resposta

200 - application/json

OK

id
string
obrigatório

Identificador de prompt único

object
any
obrigatório

Tipo de objeto

name
string
obrigatório

Nome do prompt legível por humanos

active_version
integer
obrigatório

Número da versão atualmente ativa

Intervalo obrigatório: -9007199254740991 <= x <= 9007199254740991
latest_version
integer
obrigatório

Número da versão mais recente

Intervalo obrigatório: -9007199254740991 <= x <= 9007199254740991
metadata
object
obrigatório

Chaves-valor de metadados personalizados

created_at
string<date-time>
obrigatório

Timestamp quando o prompt foi criado

updated_at
string<date-time>
obrigatório

Timestamp quando o prompt foi atualizado pela última vez

description
string

Descrição detalhada do prompt