Revocar Consentimiento

POST /cl/consent_manager/revoke_consent

Cambia el estado de un consentimiento de ACTIVE (o EXPIRING_SOON) a REVOKED. Falla si el consentimiento está en cualquier otro estado.

URL de producción: https://api.floid.app/cl/consent_manager/revoke_consent
URL de sandbox: https://sandbox.floid.app/cl/consent_manager/revoke_consent

Contrato en inglés. Los nombres de los campos del request y de la respuesta van en inglés. Los errores usan el envelope legacy con un error_code granular.

Headers requeridos

Authorization: Bearer {{TOKEN}}
Content-Type: application/json

Identificador

Envía el consent_token en el body:

Campo	Tipo	Requerido	Descripción
`consent_token`	string	Sí	UUID Floid devuelto por `create_consent`.

Ejemplo

curl --location --request POST 'https://api.floid.app/cl/consent_manager/revoke_consent' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer {{TOKEN}}' \
  --data '{ "consent_token": "550e8400-e29b-41d4-a716-446655440000" }'

Respuesta exitosa (200)

El data es el consentimiento actualizado (campos en inglés), ahora en estado REVOKED.

{
  "code": 200,
  "msg": "Consent revoked",
  "caseid": "550e8400-e29b-41d4-a716-446655440000",
  "data": {
    "id": 12345,
    "consent_token": "550e8400-e29b-41d4-a716-446655440000",
    "client_id": 42,
    "framework": "REDEC",
    "person_type": "NATURAL",
    "person_rut": "12345678-9",
    "institution_code": "123456789",
    "internal_code": "BCH-NAT-001",
    "purpose": 2,
    "objective": "02",
    "medium": 1,
    "state": "REVOKED",
    "validity_origin": "REDEC_REGULATION",
    "granted_date": "20260512",
    "expiration_date": "20260602",
    "expiration_time": "235959",
    "revoked_at": "2026-05-12T18:30:22.000Z",
    "evidence_status": "SUCCESS",
    "evidence_file_format": "PDF_A",
    "created_by": "GATEWAY_API",
    "has_attorneys": false,
    "caseid": "550e8400-e29b-41d4-a716-446655440000"
  }
}

Errores

`error_code`	`error_type`	HTTP	Cuándo
`MISSING_CONSENT_IDENTIFIER`	GATEWAY	400	No se envió `consent_token` en el body.
`INVALID_STATE_FOR_REVOKE`	STATE	400	El consentimiento no está `ACTIVE`/`EXPIRING_SOON` (ej. ya `REVOKED` o `EXPIRED`). El estado actual va en `display_message`.
`CONSENT_NOT_FOUND`	NOT_FOUND	404	El `consent_token` no existe para tu cliente.
`INTERNAL_ERROR`	INTERNAL	500	Error de base de datos durante la actualización.