Documentación API pública V1 — Trowel Developers

PUT/api/public/v1/snag-points/{id}/comments/{commentId}

snag-points:write

Parámetros

iduuidobligatorioruta

Repaso.

commentIduuidobligatorioruta

Comentario.

Body de entrada

PublicSnagPointCommentWrite

Guardar comentario

Metadatos JSON del comentario. El multipart admite una sola imagen.

PropiedadTipoDescripción

textobligatoriostringTexto.

removeImagebooleanQuita la imagen al editar.

Ejemplo JSON

{
  "text": "Revisado",
  "removeImage": false
}

Respuesta

200Comentario actualizado.

PublicSnagPointComment

Comentario de repaso

Comentario con una imagen opcional.

PropiedadTipoDescripción

idobligatoriouuidIdentificador.

snagPointIdobligatoriouuidRepaso.

textobligatoriostringTexto.

hasImageobligatoriobooleanTiene imagen.

createdAtobligatoriodate-timeCreación.

modifiedAtobligatoriodate-timeModificación.

Ejemplo JSON

{
  "id": "83645fdb-54c2-447b-a115-00de63c66c8a",
  "snagPointId": "cbefdbb8-acde-49f9-8cc5-390024315c2b",
  "text": "Aviso del administrador",
  "hasImage": true,
  "createdAt": "2026-10-10T12:00:00",
  "modifiedAt": "2026-10-10T12:00:00"
}

Ejemplo de respuesta

{
  "id": "83645fdb-54c2-447b-a115-00de63c66c8a",
  "snagPointId": "cbefdbb8-acde-49f9-8cc5-390024315c2b",
  "text": "Aviso del administrador",
  "hasImage": true,
  "createdAt": "2026-10-10T12:00:00",
  "modifiedAt": "2026-10-10T12:00:00"
}

Errores

400Solicitud incorrectaapplication/json

401Autenticación inválida o no proporcionadaapplication/json

403Permisos insuficientesapplication/json

404Recurso no encontradoapplication/json

409Conflicto con el estado actualapplication/json

410Recurso ya no disponibleapplication/json

422Error de validaciónapplication/json

429Límite de solicitudes excedidoapplication/json

Ver modelo de error

PublicApiError

Error de API

Formato estable de los errores públicos.

PropiedadTipoDescripción

statusobligatoriointegerCódigo HTTP.

codeobligatoriostringCódigo estable para tratamiento automático.

messageobligatoriostringMensaje legible.

correlationIdobligatoriostringIdentificador para soporte y trazabilidad.

currentConcurrencyTokenstring | nullToken actual cuando existe un conflicto.

validationErrorsobject<string,string[]>Errores agrupados por campo.

Ejemplo JSON

{
  "status": 422,
  "code": "validation_error",
  "message": "The request is invalid.",
  "correlationId": "01J9EXAMPLE",
  "validationErrors": {
    "unitCode": [
      "The unit does not exist."
    ]
  }
}