Ucotron Cortex
Referencia de API

Suscripciones de vigilancia por AOI y peligro.

Guía del flujo: Watch y webhooks

GET
/v1/watch/subscriptions

Authorization

bearerFixtureToken
AuthorizationBearer <token>

Token fixture del sandbox. Hay tres: acceso completo, sólo lectura y otra organización — para poder ejercitar 200, 403 y 404 cross-tenant. Ninguno es un secreto.

In: header

Query Parameters

cursor?string

Opaco. Usá el nextCursor de la página anterior; construirlo a mano se rompe cuando cambie la paginación.

limit?integer
Range1 <= value <= 250
Default25

Header Parameters

x-ucotron-tenant-id?string

Organización. Si viene, tiene que coincidir con la de la credencial: un header que la sobreescribiera sería el propio bypass.

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/v1/watch/subscriptions"
{  "data": [    {      "subscriptionId": "watch_sbox_535b0a61",      "aoiIds": [        "aoi_sbox_f0c86d81",        "aoi_sbox_d3a304ba"      ],      "perils": [        "hail",        "flood"      ],      "minSeverity": "medium",      "status": "active",      "createdAt": "2025-11-20T12:00:00.000Z"    }  ],  "page": {    "nextCursor": null,    "previousCursor": null,    "limit": 25,    "hasMore": false  }}