---
updatedAt: 2026-08-14T01:21:22.000Z
agentTools:
  projectIndex: https://readme.cipherowl.ai/llms.txt
---

# Remove addresses from a pool

Removes addresses from a pool (soft delete).

**Behavior:**
- At most 1000 addresses per request.
- Per-address report in results: removed=true for each address removed, removed=false for addresses not live in the pool (not an error).
- Re-adding a removed address later resurrects the same member with a fresh baseline and a continuous history lineage.

# OpenAPI definition

```json
{
  "openapi": "3.0.3",
  "info": {
    "title": "API ENDPOINTS",
    "description": "CipherOwl blockchain compliance and risk assessment APIs.",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://svc.cipherowl.ai"
    }
  ],
  "security": [
    {
      "BearerAuth": []
    }
  ],
  "tags": [
    {
      "name": "Continuous Monitoring",
      "description": "Monitor pools of blockchain addresses for risk changes. Create address pools, manage their membership, re-baseline accepted risk, and consume the pool's time-ordered feed of risk-change events (or one address's history). Members are identified by chain (e.g. `evm`) and address."
    }
  ],
  "paths": {
    "/api/monitoring/v1/pools/{poolId}/addresses:batchDelete": {
      "post": {
        "summary": "Remove addresses from a pool",
        "description": "Removes addresses from a pool (soft delete).\n\n**Behavior:**\n- At most 1000 addresses per request.\n- Per-address report in results: removed=true for each address removed, removed=false for addresses not live in the pool (not an error).\n- Re-adding a removed address later resurrects the same member with a fresh baseline and a continuous history lineage.",
        "operationId": "MonitoringService_RemoveAddresses",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1RemoveAddressesResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "poolId",
            "description": "Pool id, as returned by CreatePool/ListPools (a UUID). At most 64 bytes.",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "Continuous Monitoring"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/MonitoringServiceRemoveAddressesBody"
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "BearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT",
        "description": "OAuth 2.0 access token obtained from /oauth/token using client credentials."
      }
    },
    "schemas": {
      "MonitoringServiceRemoveAddressesBody": {
        "type": "object",
        "properties": {
          "addresses": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1AddressEntry"
            },
            "description": "At most 1000 entries."
          }
        }
      },
      "v1AddressEntry": {
        "type": "object",
        "properties": {
          "chain": {
            "type": "string",
            "description": "Chain of the address, for example evm, bitcoin, tron, solana, xrp or\nlitecoin (the rejection message lists the full set). Risk is evaluated\nper chain, so a member is identified by chain + address. A canonicalized\nentry is echoed as its canonical chain, including one screening later\nmarks INVALID; an entry that could not be canonicalized is echoed exactly\nas submitted. A chain outside the supported set is rejected: AddAddresses\nfails the whole request with InvalidArgument, RemoveAddresses reports the\nentry as not removed. At most 128 bytes."
          },
          "address": {
            "type": "string",
            "description": "At most 1024 bytes as submitted; the canonical (stored) form is capped\nat 320 bytes after normalization."
          }
        }
      },
      "v1RemovalResult": {
        "type": "object",
        "properties": {
          "address": {
            "allOf": [
              {
                "$ref": "#/components/schemas/v1AddressEntry"
              }
            ],
            "description": "The canonicalized entry (chain + normalized address); echoed as\nsubmitted when the entry could not be canonicalized."
          },
          "removed": {
            "type": "boolean",
            "description": "False when the address was not live in the pool (not an error).\nExplicit presence so `removed: false` is emitted on the wire."
          }
        }
      },
      "v1RemoveAddressesResponse": {
        "type": "object",
        "properties": {
          "removedCount": {
            "type": "integer",
            "format": "int32"
          },
          "results": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1RemovalResult"
            },
            "description": "Per-address report, in request order."
          }
        }
      }
    }
  }
}
```