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

# Delete vectors by ID

> Delete one or more vectors from the collection by their user-provided
string IDs. IDs that do not exist are silently ignored.

Supports both binary protobuf (`application/protobuf`) and ProtoJSON
(`application/protobuf+json`) request bodies.




## OpenAPI

````yaml /openapi/vector.yaml post /api/v1/vector/delete
openapi: 3.1.0
info:
  title: OpenData Vector API
  version: 1.0.0
  description: >-
    HTTP API for the OpenData Vector service — a semantic search database on
    object storage.
servers:
  - url: http://localhost:8080
    description: Local development server
security: []
paths:
  /api/v1/vector/delete:
    post:
      summary: Delete vectors by ID
      description: |
        Delete one or more vectors from the collection by their user-provided
        string IDs. IDs that do not exist are silently ignored.

        Supports both binary protobuf (`application/protobuf`) and ProtoJSON
        (`application/protobuf+json`) request bodies.
      operationId: delete
      requestBody:
        required: true
        content:
          application/protobuf+json:
            schema:
              $ref: '#/components/schemas/DeleteRequest'
            example:
              ids:
                - doc-1
                - doc-2
          application/protobuf:
            schema:
              type: string
              format: binary
      responses:
        '200':
          description: Vectors deleted successfully.
          content:
            application/protobuf+json:
              schema:
                $ref: '#/components/schemas/DeleteVectorsResponse'
              example:
                status: success
                vectorsDeleted: 2
        '400':
          description: Invalid input (malformed body, empty ID).
          content:
            application/protobuf+json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal server error.
          content:
            application/protobuf+json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    DeleteRequest:
      type: object
      description: Request body for deleting vectors by ID.
      properties:
        ids:
          type: array
          items:
            type: string
            maxLength: 64
          description: User-provided IDs of the vectors to delete (up to 64 bytes each).
      required:
        - ids
    DeleteVectorsResponse:
      type: object
      description: Response after successfully deleting vectors.
      properties:
        status:
          type: string
          example: success
        vectorsDeleted:
          type: integer
          format: int32
          description: >-
            Number of vectors in the request. IDs that did not exist are still
            counted.
      required:
        - status
        - vectorsDeleted
    ErrorResponse:
      type: object
      description: Error response returned for all error cases.
      properties:
        status:
          type: string
          example: error
        message:
          type: string
          description: Human-readable error message.
      required:
        - status
        - message

````