Skip to main content
POST
/
v1
/
integration
/
prompts
/
{prompt_id}
/
versions
Create version
curl --request POST \
  --url https://api.aivra.cloud/v1/integration/prompts/{prompt_id}/versions \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "content": "<string>",
  "change_summary": "<string>",
  "metadata_": {}
}
'
{
  "id": "<string>",
  "prompt_id": "<string>",
  "version_number": 123,
  "content": "<string>",
  "metadata_": {},
  "created_at": "2023-11-07T05:31:56Z"
}

​
Propósito

Cria uma nova versão de conteúdo para um prompt.

​
Parâmetros

  • prompt_id (path, string) obrigatório
  • Corpo JSON:
    • content (string) obrigatório
    • change_summary (string) opcional
    • metadata_ (object) opcional

​
Dados retornados

id, prompt_id, version_number, content, metadata_, created_at.

​
Exemplo

curl -X POST "${BASE_URL}/v1/integration/prompts/pr_1/versions" \
  -H "X-API-Key: ak_xxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Bem-vindo ao app!",
    "change_summary": "Atualização do tom",
    "metadata_": { "lang": "pt-BR" }
  }'

​
Códigos de status

  • 200 Sucesso
  • 404 Prompt não encontrado
  • 403 Projeto não autorizado pela API Key

​
Casos de uso

  • Evoluir conteúdo mantendo histórico e versionamento

Authorizations

​
X-API-Key
string
header
required

Path Parameters

​
prompt_id
string
required

Body

application/json
​
content
string
required
​
change_summary
string | null
​
metadata_
object

Response

200 - application/json

OK

​
id
string
required
​
prompt_id
string
required
​
version_number
integer
required
​
content
string
required
​
metadata_
object
​
created_at
string<date-time> | null