Skip to main content

POST Ativar Versão do Modelo

Põe uma versão já salva em uso, sem criar versão nova. A que estava em uso deixa de valer.

Autenticação necessária

Envie o header Authorization: Bearer {accessToken} (token de usuário) ou x-api-key: {apiKey} (integrações). Veja Autenticação.

Permissão necessária

Exige a permissão update_document_templates.


Endpoint​

POST https://api-dev.imagemais.com.br/api/document-templates/{type}/versions/{version}/activate

Parâmetros de Rota​

NomeTipoObrigatórioDescrição
typestring✅Tipo do documento: LETTERHEAD, PRESCRIPTION, EXAMS, REFERRAL, MEDICAL_CERTIFICATE, DECLARATION, LIFESTYLE_ADVICE, APPOINTMENT_RECEIPT, PROCEDURE_REFERRAL, BUDGET, COLLECTION_RECEIPT, STANDALONE_DECLARATION, RAPID_TEST_HISTORY
versionnumber✅Número da versão

Requisição​

curl -X 'POST' \
'https://api-dev.imagemais.com.br/api/document-templates/PRESCRIPTION/versions/2/activate' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}'

Respostas​

200 Sucesso​

{
"type": "PRESCRIPTION",
"version": 2,
"active": true,
"createdAt": "2026-11-10T14:00:00.000Z",
"createdBy": {
"id": 12,
"name": "Nome Exemplo"
}
}

400 Requisição inválida​

Retornado quando type não é um dos tipos válidos ou version não é numérico (Validation failed (numeric string is expected)).

{
"message": "Validation failed (enum string is expected)",
"error": "Bad Request",
"statusCode": 400
}

403 Sem permissão​

{
"message": "Permissões insuficientes",
"error": "Forbidden",
"statusCode": 403
}

404 Não encontrado​

{
"message": "Versão do modelo não encontrada",
"error": "Not Found",
"statusCode": 404
}