Projetos
Listar Projetos
Obter todos os projetos do tenant ativo.
GET /api/projects
Retorna todos os projetos do tenant ativo, ordenados por nome. A lista não é paginada.
Auth: Necessária — permissão project:view
Este endpoint é tenant-level: ignora o header x-project-id.
Exemplo
curl -X GET https://api.reten.ai/api/projects \
-H "Authorization: Bearer <token>" \
-H "x-tenant-id: <tenant-id>"const response = await fetch("https://api.reten.ai/api/projects", {
headers: {
"Authorization": "Bearer <token>",
"x-tenant-id": "<tenant-id>",
},
});
const projects = await response.json();import requests
response = requests.get(
"https://api.reten.ai/api/projects",
headers={
"Authorization": "Bearer <token>",
"x-tenant-id": "<tenant-id>",
},
)
projects = response.json()Resposta 200 OK
[
{
"id": "b7e4d2c1-6a5f-4e3d-9c8b-7a6f5e4d3c2b",
"name": "Food Service",
"rootAudienceId": "c2d3e4f5-a6b7-4c8d-9e0f-1a2b3c4d5e6f",
"isMain": false
},
{
"id": "3f6c2b1a-8d4e-4f7a-9b2c-5e1d0a7f6c34",
"name": "General",
"rootAudienceId": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",
"isMain": true
}
]Campos da Resposta
| Campo | Tipo | Descrição |
|---|---|---|
id | string | UUID do projeto |
name | string | Nome do projeto |
rootAudienceId | string | UUID da audiência raiz do projeto |
isMain | boolean | true para o projeto principal do tenant |
Respostas de Erro
| Status | Descrição |
|---|---|
401 | Token de autenticação ausente ou inválido |
403 | Falta a permissão project:view — Required permissions: project:view |