Documentación API pública V1 — Trowel Developers

GET/api/public/v1/snag-points/{id}/state-history

snag-points:read

Parámetros

iduuidobligatorioruta

Repaso.

limitinteger1..200opcionalquery

Número máximo de elementos por página. Por defecto 50, máximo 200.

cursorstringopcionalquery

Cursor opaco para continuar desde la respuesta anterior.

modifiedSincedate-time localopcionalquery

Incluye registros creados o modificados después de esta fecha, interpretada en el timezone del tenant.

Respuesta

200Historial de estados.

PublicSnagPointHistory

Transición de estado

Cambio de estado registrado en el historial del repaso.

PropiedadTipoDescripción

idobligatoriouuidIdentificador.

snagPointIdobligatoriouuidRepaso.

stateobligatoriostringEstado alcanzado.

commentstring | nullComentario de la transición.

photoCountobligatoriointegerFotos de esta transición.

currentobligatoriobooleanIndica que esta transición representa el estado vigente.

createdAtobligatoriodate-timeFecha de la transición.

Ejemplo JSON

{
  "id": "ac1edabe-babf-4099-9ce6-2253fc817def",
  "snagPointId": "cbefdbb8-acde-49f9-8cc5-390024315c2b",
  "state": "pending",
  "photoCount": 2,
  "current": true,
  "createdAt": "2026-10-10T12:00:00"
}

Ejemplo de respuesta

{
  "items": [
    {
      "id": "ac1edabe-babf-4099-9ce6-2253fc817def",
      "snagPointId": "cbefdbb8-acde-49f9-8cc5-390024315c2b",
      "state": "pending",
      "photoCount": 2,
      "current": true,
      "createdAt": "2026-10-10T12:00:00"
    }
  ],
  "nextCursor": "eyJ2ZXJzaW9uIjoxLCJvZmZzZXQiOjUwfQ",
  "hasMore": true
}

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."
    ]
  }
}