Listar Proyectos

GET /api/projects

Devuelve todos los proyectos del tenant activo, ordenados por nombre. La lista no está paginada.

Auth: Requerida — permiso project:view

Este endpoint es tenant-level: ignora el header x-project-id.

Ejemplo

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()

Respuesta `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 de la Respuesta

Campo	Tipo	Descripción
`id`	string	UUID del proyecto
`name`	string	Nombre del proyecto
`rootAudienceId`	string	UUID de la audiencia raíz del proyecto
`isMain`	boolean	`true` para el proyecto principal del tenant

Respuestas de Error

Estado	Descripción
`401`	Token de autenticación faltante o inválido
`403`	Falta el permiso `project:view` — `Required permissions: project:view`