Skip to main content

GET Buscar Configuração de IA

Retorna os provedores de IA configurados na conta (com a chave mascarada) e qual provedor atende cada capacidade.

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


Endpoint​

GET https://api-dev.imagemais.com.br/api/ai/settings

Requisição​

curl -X 'GET' \
'https://api-dev.imagemais.com.br/api/ai/settings' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}'

Respostas​

200 Sucesso​

{
"providers": [
{
"provider": "OPENAI",
"configured": false,
"updatedAt": null
}
],
"capabilities": [
{
"capability": "TEXT_GENERATION",
"provider": "OPENAI",
"configured": true,
"availableProviders": [
"OPENAI"
],
"updatedAt": "2026-08-28T10:49:11.535Z"
}
]
}

403 Sem permissão​

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

500 Erro interno​

{
"message": "Erro ao buscar a configuração de IA.",
"error": "Internal Server Error",
"statusCode": 500
}