Sugerencias

Las sugerencias son propuestas de mejora basadas en texto para flujos de trabajo y paquetes de contexto. Cualquiera que pueda leer un paquete puede crear uno; sólo el autor puede actualizarlo y sólo el propietario del paquete puede resolverlo. Consulte Sugerencias para conocer el ciclo de vida y el modelo de permisos.

accountId se resuelve a partir del token de autenticación y nunca se pasa en la solicitud. El espacio de trabajo activo proviene del token o del parámetro de consulta workspaceId. Crear una sugerencia cuesta 5 créditos; cotizar cuesta 2 créditos; leer, actualizar y resolver cuestan 1 crédito cada uno.

Crea una sugerencia

POST /v1/suggestions
Authorization: Bearer <token>
Content-Type: application/json
 
{
  "reference": "@market-research",
  "title": "Add review step",
  "content": "Add a final human review before publishing."
}

reference es un ID de paquete, @alias, una URL compartida o una URL central. Se requieren title y content. Devuelve 201. El contenido del paquete en el momento de la creación se captura como una instantánea. Cada cuenta puede crear hasta 20 sugerencias por día.

Lista de sugerencias

POST /v1/suggestions/search
Authorization: Bearer <token>
Content-Type: application/json
 
{
  "owner": true,
  "statuses": ["open"]
}

El cuerpo de búsqueda refleja las banderas CLI:

• omita owner y reference para enumerar las sugerencias que usted envió**.
• owner: true regresa a tu bandeja de entrada: sugerencias sobre paquetes de tu propiedad.
• reference devuelve sugerencias para un paquete (opcionalmente reducida por author).

Filtros statuses por open, applied, declined y archived. Utilice page para paginar (tamaño de página 20) y includeSnapshots para incluir contenido del paquete capturado. La respuesta incluye suggestions, totalCount, page y pageSize.

El content de cada sugerencia en la respuesta de la lista es una vista previa truncada. Obtenga el contenido completo con GET /v1/suggestions/:id, reflejando el esquema del paquete → patrón completo.

Recibe una sugerencia

curl "https://api.epismo.ai/v1/suggestions/$SUGGESTION_ID?includeSnapshot=true" \
  -H "authorization: Bearer $EPISMO_TOKEN"

includeSnapshot=true agrega el contenido del paquete capturado a la respuesta. Se omite por defecto.

Actualizar una sugerencia

PATCH /v1/suggestions/:id
Authorization: Bearer <token>
Content-Type: application/json
 
{
  "title": "Add review step",
  "content": "Please add a reviewer approval step before publish."
}

Sólo el autor puede actualizar el título o el contenido de una sugerencia.

Resolver una sugerencia

PATCH /v1/suggestions/:id/resolve
Authorization: Bearer <token>
Content-Type: application/json
 
{
  "status": "applied"
}

status es uno de open, applied, declined o archived. Sólo el propietario del pack puede resolver una sugerencia. La resolución cambia sólo el estado; aplique el cambio real con una actualización del paquete primero al aceptar una sugerencia.