Skip to main content
GET
/
v1
/
integration
/
prompts
/
{prompt_id}
/
version
/
active
Get active version
curl --request GET \
  --url https://api.aivra.cloud/v1/integration/prompts/{prompt_id}/version/active \
  --header 'X-API-Key: <api-key>'
{
  "id": "<string>",
  "prompt_id": "<string>",
  "version_number": 123,
  "content": "<string>",
  "metadata_": {},
  "created_at": "2023-11-07T05:31:56Z"
}

​
Propósito

Retorna a versão ativa de um prompt em um ambiente específico.

​
Parâmetros

  • prompt_id (path, string) obrigatório
  • environment (query, string) obrigatório

​
Dados retornados

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

​
Exemplo

curl -H "X-API-Key: ak_xxxxxxxxx" \
  "${BASE_URL}/v1/integration/prompts/pr_1/version/active?environment=production"
Resposta: 
{
  "id": "ver_12",
  "prompt_id": "pr_1",
  "version_number": 12,
  "content": "...",
  "metadata_": null,
  "created_at": "2025-11-27T12:00:00Z"
}

​
Códigos de status

  • 200 Sucesso
  • 404 Versão ativa não encontrada
  • 403 Acesso negado por workspace/projeto

​
Casos de uso

  • Obter o conteúdo atual utilizado pelo seu serviço em determinado ambiente

Authorizations

​
X-API-Key
string
header
required

Path Parameters

​
prompt_id
string
required

Query Parameters

​
environment
string
required

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