Skip to main content
PATCH
/
entities
/
toggle-status-monitoring
Enable or disable monitoring by entity and integration
curl --request PATCH \
  --url http://api.gu1.ai/entities/toggle-status-monitoring \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "entityId": "<string>",
  "integrationCode": "<string>",
  "active": true,
  "riskMatrixId": {}
}
'
PATCH http://api.gu1.ai/entities/toggle-status-monitoring
Generic endpoint to set whether an entity participates in continuous monitoring for a given integrationCode (server behaviour depends on the code; today: Gueno global sanctions).

​
Authentication

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Requires edit permission on the entity referenced by entityId.

​
JSON body

​
entityId
string
required
Entity UUID (must belong to your organization).
​
integrationCode
string
required
Integration / enrichment code. Supported today: global_gueno_sanctions_enrichment.
Other values return 400 UNSUPPORTED_MONITORING_INTEGRATION.
​
active
boolean
  • true — include in continuous monitoring when org and upstream allow (re-enable).
  • false — exclude (same as legacy monitoringOptOut: true). At least one of active or riskMatrixId must be sent.
​
riskMatrixId
string | null
Optional. Gueno global sanctions only. UUID of a risk matrix in your org, or null to clear the per-subscription override (daily screening then uses the entity risk matrix again, same as before). When a UUID is set, only that matrix is used for rules triggered by monitoring (e.g. trigger_monitoring_completed after daily screening); the entity’s assigned matrix is not merged in for that run. Does not update entities.riskMatrixId.

​
Error responses

HTTPCode (example)When
404ENTITY_NOT_FOUNDEntity not in org.
400UNSUPPORTED_MONITORING_INTEGRATIONNo handler for integrationCode, or riskMatrixId on an unsupported code.
400INVALID_RISK_MATRIXMatrix missing, archived, or not in org.

​
Example — turn off Gueno monitoring

curl -sS -X PATCH "http://api.gu1.ai/entities/toggle-status-monitoring" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "entityId": "550e8400-e29b-41d4-a716-446655440000",
    "integrationCode": "global_gueno_sanctions_enrichment",
    "active": false
  }'

​
Deprecated route

PATCH /entities/{id}/gueno-sanctions-monitoring-opt-out with { "monitoringOptOut" } is deprecated; use this endpoint with active: !monitoringOptOut.