> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vectoraidb.actian.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete points

> Delete points from a collection by specifying a list of point IDs.



## OpenAPI

````yaml post /collections/{collection_name}/points/delete
openapi: 3.0.3
info:
  title: Actian VectorAI DB - Points API
  description: Point CRUD operations for VectorAI DB.
  version: 1.0.0
  contact:
    name: Actian Corporation
    url: https://www.actian.com
servers:
  - url: http://localhost:6573
    description: Local development server (REST API)
  - url: https://api.vectorai.actian.com
    description: Production server
security:
  - bearerAuth: []
tags:
  - name: Points
    description: Point data operations
paths:
  /collections/{collection_name}/points/delete:
    post:
      tags:
        - Points
      summary: Delete points
      description: Delete points from a collection by specifying a list of point IDs.
      operationId: delete_points
      parameters:
        - name: collection_name
          in: path
          required: true
          schema:
            type: string
          description: The name of the collection to delete points from.
          example: my_collection
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - points
              properties:
                points:
                  type: array
                  example:
                    - 1
                    - 2
                    - 3
                  description: List of point IDs to delete.
                  items:
                    oneOf:
                      - type: integer
                      - type: string
            examples:
              delete_by_ids:
                summary: Delete by IDs
                value:
                  points:
                    - 1
                    - 2
                    - 3
      responses:
        '200':
          description: Points deleted
          content:
            application/json:
              schema:
                type: object
                properties:
                  usage:
                    type: object
                    description: Resource usage information for this request.
                    properties:
                      hardware:
                        type: object
                        nullable: true
                        description: >-
                          Hardware resource counters for the operation,
                          including CPU, payload I/O, payload index I/O, and
                          vector I/O metrics.
                  time:
                    type: number
                    format: double
                    example: 0.000119036
                    description: Time spent to process this request, in seconds.
                  status:
                    type: string
                    example: ok
                    description: Operation status. Returns `ok` on success.
                  result:
                    type: object
                    description: Operation result containing the status of the deletion.
                    properties:
                      operation_id:
                        type: integer
                        example: 0
                        description: Unique identifier for the operation.
                      status:
                        type: string
                        example: Completed
                        description: >-
                          Status of the operation. Returns `Completed` when the
                          operation finishes successfully.
              example:
                usage:
                  hardware: null
                time: 0.000119036
                status: ok
                result:
                  operation_id: 0
                  status: Completed
        4XX:
          description: Error response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      x-codeSamples:
        - lang: Python
          label: Delete by IDs
          source: |
            from actian_vectorai_client import VectorAIClient

            with VectorAIClient("localhost:6574") as client:
                # Delete specific points by ID
                result = client.points.delete_by_ids("my_collection", ids=[100, 101, 102])
                print(f"✓ Deleted points")
        - lang: Python
          label: Delete by filter
          source: >
            from actian_vectorai_client import VectorAIClient, Field,
            FilterBuilder


            with VectorAIClient("localhost:6574") as client:
                # Delete points matching filter
                filter = FilterBuilder().must(Field("category").eq("C")).build()
                result = client.points.delete("my_collection", filter=filter)
                print(f"✓ Deleted category C points")
        - lang: JavaScript
          label: Delete by IDs
          source: >
            import { VectorAIClient } from '@actian/vectorai-client';


            const client = new VectorAIClient('localhost:6574');


            await client.points.deleteByIds('my_collection', [1, 2, 3], { wait:
            true });

            console.log('Deleted points 1, 2, 3');


            client.close();
        - lang: cURL
          label: Delete by IDs
          source: >
            curl -X POST
            "http://localhost:6573/collections/my_collection/points/delete" \
              -H "Content-Type: application/json" \
              -H 'Authorization: Bearer <admin-jwt-or-access-token>' \
              -d '{
                "points": [1, 2, 3]
              }'
components:
  schemas:
    ErrorResponse:
      type: object
      description: Error response returned when a request fails.
      properties:
        status:
          type: object
          description: Status object containing the error message.
          properties:
            error:
              type: string
              description: Human-readable error message describing what went wrong.
              example: Collection `my_collection` doesn't exist!
        time:
          type: number
          format: double
          description: Time spent to process this request, in seconds.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Admin JWT or access token for authenticating requests to VectorAI DB.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.