> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # Cancelar un marcador de fraude > Se cancela un marcador de fraude de DICT por su ID de recurso en el directorio, dentro del alcance del participante determinado por el tenant autenticado. La solicitud no tiene cuerpo. La cancelación de un marcador que ya está CANCELLED es idempotente y devuelve 200 sin cambios. Devuelve 404 para un ID de recurso desconocido, 403 cuando el participante no está autorizado para cancelar el marcador y 409 para otro conflicto de estado. ## OpenAPI ````yaml es/openapi/v3-current/pix-lerian-dict.yaml POST /dict/fraud-markers/{fraud_marker_id}/cancel openapi: 3.1.0 info: contact: name: Lerian Studio url: https://lerian.studio description: >- API pública para claves Pix, reclamos, marcadores de fraude, reportes de infracción y recuperación de fondos del MED. license: name: Elastic License 2.0 url: https://www.elastic.co/licensing/elastic-license title: Pix Lerian — DICT version: release-candidate servers: - url: https://api.example.com/dict-hub/v1 description: >- El host de ejemplo debe reemplazarse por la URL proporcionada durante el onboarding del entorno. security: - BearerAuth: [] tags: - description: Registro, consulta, listado, actualización y eliminación de claves Pix. name: Entries - description: >- Consulta de claves Pix y verificación de su existencia en el directorio DICT. name: Keys - description: Gestión de reclamaciones de titularidad y portabilidad de claves Pix. name: Claims - description: Gestión de recuperaciones de fondos de MED 2.0 asociadas al participante. name: Funds Recoveries - description: >- Gestión de reportes de infracción de MED 2.0 para la organización autenticada. name: Infraction Reports - description: Creación, consulta, cancelación y liquidación de devoluciones de MED 2.0. name: Refunds - description: Creación, consulta, listado y cancelación de marcadores de fraude de DICT. name: Fraud Markers paths: /dict/fraud-markers/{fraud_marker_id}/cancel: post: tags: - Fraud Markers summary: Cancelar un marcador de fraude description: >- Se cancela un marcador de fraude de DICT por su ID de recurso en el directorio, dentro del alcance del participante determinado por el tenant autenticado. La solicitud no tiene cuerpo. La cancelación de un marcador que ya está CANCELLED es idempotente y devuelve 200 sin cambios. Devuelve 404 para un ID de recurso desconocido, 403 cuando el participante no está autorizado para cancelar el marcador y 409 para otro conflicto de estado. operationId: cancelFraudMarker parameters: - description: Directory fraud-marker id (UUID) in: path name: fraud_marker_id required: true schema: description: Directory fraud-marker id (UUID) examples: - 0b843bcc-7c1a-4a12-9c88-8d3a5d70e6a1 format: uuid type: string example: 019606e5-7f80-9102-3d45-678901234ef0 responses: '200': content: application/json: schema: $ref: '#/components/schemas/DICTFraudMarker' examples: ejemploFicticio: summary: Ejemplo ficticio value: creationTime: '2026-08-21T10:00:00Z' fraudType: APPLICATION_FRAUD id: 0b843bcc-7c1a-4a12-9c88-8d3a5d70e6a1 infractionReport: id: 5e6f7a8b-9c0d-4e1f-8a2b-3c4d5e6f7a8b reporterParticipant: '18236120' key: '+5561999998888' lastModified: '2026-08-21T10:00:00Z' status: REGISTERED taxIdNumber: '12345678901' description: >- The cancelled marker (status CANCELLED). Also returned, unchanged, on an idempotent re-cancel of an already-CANCELLED marker. '400': content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: Malformed fraud_marker_id path parameter -- not a UUID (PIX-0015). '403': content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: >- The requesting participant is not authorized to perform this operation at the provider (PIX-0133). '404': content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: No fraud marker exists with this id at the provider (PIX-0130). '409': content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: >- The provider rejected the operation for a genuine state conflict unrelated to idempotent re-cancellation (PIX-0131). '429': content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: The provider rate-limited this operation; retry later (PIX-0134). '502': content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: >- The provider adapter call failed outright -- an unreachable adapter or an unclassified upstream failure (PIX-0141). '504': content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: The provider call did not complete within its deadline (PIX-0054). default: content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: Error x-codeSamples: - lang: bash label: cURL con datos ficticios source: |- curl --request POST \ --url https://api.example.com/dict-hub/v1/dict/fraud-markers/019606e5-7f80-9102-3d45-678901234ef0/cancel \ --header 'Authorization: Bearer demo-access-token' components: schemas: DICTFraudMarker: additionalProperties: false properties: creationTime: description: When the marker was registered at the provider (RFC 3339 UTC) examples: - '2026-08-21T10:00:00Z' format: date-time type: string fraudType: enum: - APPLICATION_FRAUD - MULE_ACCOUNT - SCAMMER_ACCOUNT - OTHER - UNKNOWN examples: - APPLICATION_FRAUD type: string id: description: Directory fraud-marker id examples: - 0b843bcc-7c1a-4a12-9c88-8d3a5d70e6a1 format: uuid type: string infractionReport: $ref: '#/components/schemas/DICTFraudMarkerInfractionReport' description: >- The infraction report the provider created this marker from, when applicable key: description: Pix key linked to the marker, when one was supplied on create examples: - '+5561999998888' type: string lastModified: description: When the marker was last modified at the provider (RFC 3339 UTC) examples: - '2026-08-21T10:00:00Z' format: date-time type: string status: enum: - REGISTERED - CANCELLED examples: - REGISTERED type: string taxIdNumber: description: CPF (11 digits) or numeric CNPJ (14 digits) marked examples: - '12345678901' type: string required: - id - status - taxIdNumber - fraudType - creationTime - lastModified type: object Detail: additionalProperties: false properties: code: description: >- Stable, machine-readable domain error code scoped to the emitting service (format: -NNNN). examples: - ERR-0001 type: string detail: description: >- A human-readable explanation specific to this occurrence of the problem. examples: - Property foo is required but is missing. type: string errors: description: Optional list of individual error details items: $ref: '#/components/schemas/ErrorDetail' type: - array - 'null' instance: description: >- A URI reference that identifies the specific occurrence of the problem. examples: - https://example.com/error-log/abc123 format: uri type: string status: description: HTTP status code examples: - 400 format: int64 type: integer title: description: >- A short, human-readable summary of the problem type. This value should not change between occurrences of the error. examples: - Bad Request type: string type: default: about:blank description: A URI reference to human-readable documentation for the error. examples: - https://example.com/errors/example format: uri type: string upstream: $ref: '#/components/schemas/Upstream' description: >- RFC 9457 extension member: the error a proxied third-party provider reported. Absent unless the emitting service explicitly surfaced one. type: object DICTFraudMarkerInfractionReport: additionalProperties: false properties: id: description: Infraction report id at the provider examples: - 5e6f7a8b-9c0d-4e1f-8a2b-3c4d5e6f7a8b type: string reporterParticipant: description: ISPB of the participant that opened the infraction report examples: - '18236120' type: string required: - id - reporterParticipant type: object ErrorDetail: additionalProperties: false properties: location: description: >- Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id' type: string message: description: Error message text type: string value: description: The value at the given location type: object Upstream: additionalProperties: false properties: code: description: The upstream provider's own error code, verbatim. examples: - E4001 type: string message: description: >- The upstream provider's own error message, verbatim (bounded, never its raw response body). examples: - account not found at provider type: string type: object securitySchemes: BearerAuth: bearerFormat: JWT description: JWT bearer token issued by the identity provider. scheme: bearer type: http ````