Actualizar Proyecto

PATCH /api/projects/:id

Renombra un proyecto. El nombre es el único campo editable de un proyecto, así que name es obligatorio aunque el método sea PATCH. La audiencia raíz se edita con PATCH /api/audience-criterias/:id — ver Proyectos → Audiencia raíz.

Auth: Requerida — permiso project:update

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

Parámetros de Ruta

Parámetro	Tipo	Descripción
`id`	UUID	ID del proyecto

Cuerpo de la Solicitud

Campo	Tipo	Requerido	Descripción
`name`	string	Sí	Nuevo nombre del proyecto (máximo 255 caracteres). Debe ser único dentro del tenant, sin distinguir mayúsculas; un proyecto puede cambiar las mayúsculas de su propio nombre

isMain no se puede cambiar: enviarlo (o cualquier campo distinto de name) responde 400.

Ejemplo

curl -X PATCH https://api.reten.ai/api/projects/b7e4d2c1-6a5f-4e3d-9c8b-7a6f5e4d3c2b \
  -H "Authorization: Bearer <token>" \
  -H "x-tenant-id: <tenant-id>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Food Service Norte"
  }'

const id = "b7e4d2c1-6a5f-4e3d-9c8b-7a6f5e4d3c2b";
const response = await fetch(`https://api.reten.ai/api/projects/${id}`, {
  method: "PATCH",
  headers: {
    "Authorization": "Bearer <token>",
    "x-tenant-id": "<tenant-id>",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    name: "Food Service Norte",
  }),
});
const project = await response.json();

import requests

project_id = "b7e4d2c1-6a5f-4e3d-9c8b-7a6f5e4d3c2b"
response = requests.patch(
    f"https://api.reten.ai/api/projects/{project_id}",
    headers={
        "Authorization": "Bearer <token>",
        "x-tenant-id": "<tenant-id>",
    },
    json={
        "name": "Food Service Norte",
    },
)
project = response.json()

Respuesta `200 OK`

{
  "id": "b7e4d2c1-6a5f-4e3d-9c8b-7a6f5e4d3c2b",
  "name": "Food Service Norte",
  "rootAudienceId": "c2d3e4f5-a6b7-4c8d-9e0f-1a2b3c4d5e6f",
  "isMain": false
}

Respuestas de Error

Estado	Descripción
`400`	`id` no es un UUID válido
`400`	`name` faltante o vacío — `El nombre del proyecto es obligatorio.`
`400`	`name` no es texto — `El nombre del proyecto debe ser texto.`
`400`	`name` supera los 255 caracteres — `El nombre del proyecto no puede superar los 255 caracteres.`
`400`	Campo desconocido en el cuerpo, como `isMain` — `property isMain should not exist`
`401`	Token de autenticación faltante o inválido
`403`	Falta el permiso `project:update` — `Required permissions: project:update`
`404`	No existe un proyecto con ese `id` en el tenant — `El proyecto no existe.`
`409`	Otro proyecto del tenant ya tiene ese nombre (sin distinguir mayúsculas) — `Ya existe un proyecto con el nombre "<name>".`