APIs.io Engineering Platform Vectorize API

The Vectorize API from APIs.io Engineering Platform — 11 operation(s) for vectorize.

Documentation

Specifications

Other Resources

🔗
PostmanCollection
https://api-evangelist.postman.co/workspace/APIs.io-Engineering-Platform/fe320942-e505-4ee8-8b7c-d72eae00d93f/collection/35240-1ab188a6-cc1f-490d-9413-9c6da20918d0?action=share&creator=35240
🔗
PostmanCapability
https://api-evangelist.postman.co/workspace/APIs.io-Engineering-Platform/fe320942-e505-4ee8-8b7c-d72eae00d93f/collection/35240-0e94f581-cbc1-48e0-b594-1f6b3d07a328?action=share&creator=35240
🔗
PostmanCapability
https://api-evangelist.postman.co/workspace/APIs.io-Engineering-Platform/fe320942-e505-4ee8-8b7c-d72eae00d93f/collection/35240-4517d93a-e7f7-4dc2-b572-06762bbe14de?action=share&creator=35240
🔗
PostmanCollection
https://api-evangelist.postman.co/workspace/APIs.io-Engineering-Platform/fe320942-e505-4ee8-8b7c-d72eae00d93f/collection/35240-88f9ddbb-3115-47dc-b6e5-7fc6f1d2a190?action=share&creator=35240
🔗
PostmanCapability
https://api-evangelist.postman.co/workspace/APIs.io-Engineering-Platform/fe320942-e505-4ee8-8b7c-d72eae00d93f/collection/35240-3a12caae-4945-4df4-8ab9-bb6219ba7a9f?action=share&creator=35240
🔗
PostmanCapability
https://api-evangelist.postman.co/workspace/APIs.io-Engineering-Platform/fe320942-e505-4ee8-8b7c-d72eae00d93f/collection/35240-863b18f0-c2f2-4e32-a5fa-0d1e6ccf77a9?action=share&creator=35240
🔗
PostmanCapability
https://api-evangelist.postman.co/workspace/APIs.io-Engineering-Platform/fe320942-e505-4ee8-8b7c-d72eae00d93f/collection/35240-189876d1-f207-49a2-a4bc-5c67ae78cd19?action=share&creator=35240
🔗
PostmanCapability
https://api-evangelist.postman.co/workspace/APIs.io-Engineering-Platform/fe320942-e505-4ee8-8b7c-d72eae00d93f/collection/35240-c1e74fd9-3f84-4d95-943d-d645d6cb82f7?action=share&creator=35240
🔗
PostmanCapability
https://api-evangelist.postman.co/workspace/APIs.io-Engineering-Platform/fe320942-e505-4ee8-8b7c-d72eae00d93f/collection/35240-b002164d-6e8a-4b6d-b409-4929476e7818?action=share&creator=35240
🔗
PostmanCollection
https://api-evangelist.postman.co/workspace/APIs.io-Engineering-Platform/fe320942-e505-4ee8-8b7c-d72eae00d93f/collection/35240-508660fd-30b8-4c9c-aede-8edbac8a514d?action=share&creator=35240
🔗
PostmanCapability
https://api-evangelist.postman.co/workspace/APIs.io-Engineering-Platform/fe320942-e505-4ee8-8b7c-d72eae00d93f/collection/35240-da35e0ba-f1a9-42fe-a77a-56ff0a47e341?action=share&creator=35240
🔗
PostmanCapability
https://api-evangelist.postman.co/workspace/APIs.io-Engineering-Platform/fe320942-e505-4ee8-8b7c-d72eae00d93f/collection/35240-1d4df7d0-9c92-4fa8-946f-2110c2b3b48d?action=share&creator=35240
🔗
PostmanCapability
https://api-evangelist.postman.co/workspace/APIs.io-Engineering-Platform/fe320942-e505-4ee8-8b7c-d72eae00d93f/collection/35240-2af6f54f-d259-46c0-8f86-78856f5885cd?action=share&creator=35240
🔗
PostmanCapability
https://api-evangelist.postman.co/workspace/APIs.io-Engineering-Platform/fe320942-e505-4ee8-8b7c-d72eae00d93f/collection/35240-cc203f31-e7f6-42ec-ad34-c5c4cde58904?action=share&creator=35240
🔗
PostmanCapability
https://api-evangelist.postman.co/workspace/APIs.io-Engineering-Platform/fe320942-e505-4ee8-8b7c-d72eae00d93f/collection/35240-f19285da-48dd-4691-bbdf-f7d6bec157a3?action=share&creator=35240
🔗
PostmanCollection
https://api-evangelist.postman.co/workspace/APIs.io-Engineering-Platform/fe320942-e505-4ee8-8b7c-d72eae00d93f/collection/35240-aa69cacc-4bbf-4724-a1d4-78cdad57fee8?action=share&creator=35240
🔗
PostmanCollection
https://api-evangelist.postman.co/workspace/APIs.io-Engineering-Platform/fe320942-e505-4ee8-8b7c-d72eae00d93f/collection/35240-a5858f86-04d3-4e15-ae11-b42c7516688b?action=share&creator=35240
🔗
PostmanCollection
https://api-evangelist.postman.co/workspace/APIs.io-Engineering-Platform/fe320942-e505-4ee8-8b7c-d72eae00d93f/collection/35240-c2052341-766c-43c7-b1dc-ed4985e4606b?action=share&creator=35240
🔗
PostmanCollection
https://api-evangelist.postman.co/workspace/APIs.io-Engineering-Platform/fe320942-e505-4ee8-8b7c-d72eae00d93f/collection/35240-aa777c90-8271-4809-8eac-3ec39a9a899c?action=share&creator=35240
🔗
PostmanCollection
https://api-evangelist.postman.co/workspace/APIs.io-Engineering-Platform/fe320942-e505-4ee8-8b7c-d72eae00d93f/collection/35240-4d5957dc-df05-4216-a5fc-d46b3ba811d8?action=share&creator=35240
🔗
PostmanCollection
https://api-evangelist.postman.co/workspace/APIs.io-Engineering-Platform/fe320942-e505-4ee8-8b7c-d72eae00d93f/collection/35240-28d97617-fdba-46a5-ac3e-40f3d2e0fa57?action=share&creator=35240
🔗
PostmanCollection
https://api-evangelist.postman.co/workspace/APIs.io-Engineering-Platform/fe320942-e505-4ee8-8b7c-d72eae00d93f/collection/35240-7429b451-d812-4abc-b497-b763372cf5c5?action=share&creator=35240
🔗
PostmanCapability
https://api-evangelist.postman.co/workspace/APIs.io-Engineering-Platform/fe320942-e505-4ee8-8b7c-d72eae00d93f/collection/35240-b0eafdd0-adaa-48a2-a855-6a31beb86d83?action=share&creator=35240
🔗
PostmanCapability
https://api-evangelist.postman.co/workspace/APIs.io-Engineering-Platform/fe320942-e505-4ee8-8b7c-d72eae00d93f/collection/35240-209f34ef-13c1-400c-bca8-fcddb304aff5?action=share&creator=35240
🔗
PostmanCapability
https://api-evangelist.postman.co/workspace/APIs.io-Engineering-Platform/fe320942-e505-4ee8-8b7c-d72eae00d93f/collection/35240-fb2bbbb8-d4cc-48b1-a660-c8e158bfbbea?action=share&creator=35240

OpenAPI Specification

engineering-platform-vectorize-api-openapi.yml Raw ↑
openapi: 3.0.0
info:
  version: "1.0.0"
  x-release: v4
  title: APIs.io Engineering Platform Amazon API Gateway 2014 11 13 Vectorize API
  description: <fullname>Amazon API Gateway</fullname> <p>Amazon API Gateway helps developers deliver robust, secure, and scalable mobile and web application back ends. API Gateway allows developers to securely connect mobile and web applications to APIs that run on AWS Lambda, Amazon EC2, or other publicly addressable web services that are hosted outside of AWS.</p>
  x-logo:
    url: https://api.apis.guru/v2/cache/logo/https_twitter.com_awscloud_profile_image.png
    backgroundColor: '#FFFFFF'
  termsOfService: https://aws.amazon.com/service-terms/
  contact:
    name: Mike Ralphson
    email: mike.ralphson@gmail.com
    url: https://github.com/mermade/aws2openapi
    x-twitter: PermittedSoc
  license:
    name: Apache 2.0 License
    url: http://www.apache.org/licenses/
  x-providerName: amazonaws.com
  x-serviceName: apigateway
  x-origin:
  - contentType: application/json
    url: https://raw.githubusercontent.com/aws/aws-sdk-js/master/apis/apigateway-2015-07-09.normal.json
    converter:
      url: https://github.com/mermade/aws2openapi
    x-apisguru-driver: external
  x-apiClientRegistration:
    url: https://portal.aws.amazon.com/gp/aws/developer/registration/index.html?nc2=h_ct
  x-apisguru-categories:
  - cloud
  x-preferred: true
servers:
- url: http://apigateway.{region}.amazonaws.com
  variables:
    region:
      description: The AWS region
      enum:
      - us-east-1
      - us-east-2
      - us-west-1
      - us-west-2
      - us-gov-west-1
      - us-gov-east-1
      - ca-central-1
      - eu-north-1
      - eu-west-1
      - eu-west-2
      - eu-west-3
      - eu-central-1
      - eu-south-1
      - af-south-1
      - ap-northeast-1
      - ap-northeast-2
      - ap-northeast-3
      - ap-southeast-1
      - ap-southeast-2
      - ap-east-1
      - ap-south-1
      - sa-east-1
      - me-south-1
      default: us-east-1
  description: The Amazon API Gateway multi-region endpoint
- url: https://apigateway.{region}.amazonaws.com
  variables:
    region:
      description: The AWS region
      enum:
      - us-east-1
      - us-east-2
      - us-west-1
      - us-west-2
      - us-gov-west-1
      - us-gov-east-1
      - ca-central-1
      - eu-north-1
      - eu-west-1
      - eu-west-2
      - eu-west-3
      - eu-central-1
      - eu-south-1
      - af-south-1
      - ap-northeast-1
      - ap-northeast-2
      - ap-northeast-3
      - ap-southeast-1
      - ap-southeast-2
      - ap-east-1
      - ap-south-1
      - sa-east-1
      - me-south-1
      default: us-east-1
  description: The Amazon API Gateway multi-region endpoint
- url: http://apigateway.{region}.amazonaws.com.cn
  variables:
    region:
      description: The AWS region
      enum:
      - cn-north-1
      - cn-northwest-1
      default: cn-north-1
  description: The Amazon API Gateway endpoint for China (Beijing) and China (Ningxia)
- url: https://apigateway.{region}.amazonaws.com.cn
  variables:
    region:
      description: The AWS region
      enum:
      - cn-north-1
      - cn-northwest-1
      default: cn-north-1
  description: The Amazon API Gateway endpoint for China (Beijing) and China (Ningxia)
security:
- hmac: []
tags:
- name: Vectorize
paths:
  /accounts/{account_id}/vectorize/v2/indexes:
    get:
      description: Returns a list of Vectorize Indexes
      operationId: vectorize-list-vectorize-indexes
      parameters:
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/vectorize_identifier'
      responses:
        4XX:
          content:
            application/json:
              schema:
                allOf:
                - allOf:
                  - $ref: '#/components/schemas/vectorize_api-response-single'
                  - properties:
                      result:
                        nullable: true
                        type: object
                    type: object
                - $ref: '#/components/schemas/vectorize_api-response-common-failure'
          description: List Vectorize Index Failure Response
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/vectorize_api-response-common'
                - properties:
                    result:
                      items:
                        $ref: '#/components/schemas/vectorize_create-index-response'
                      type: array
          description: List Vectorize Index Response
      security:
      - api_token: []
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform List Vectorize Indexes
      tags:
      - Vectorize
      x-api-token-group:
      - Vectorize Write
      - Vectorize Read
      x-cfPermissionsRequired:
        enum:
        - com.cloudflare.edge.vectorize.index.list
    post:
      description: Creates and returns a new Vectorize Index.
      operationId: vectorize-create-vectorize-index
      parameters:
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/vectorize_identifier'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/vectorize_create-index-request'
        required: true
      responses:
        4XX:
          content:
            application/json:
              schema:
                allOf:
                - allOf:
                  - $ref: '#/components/schemas/vectorize_api-response-single'
                  - properties:
                      result:
                        nullable: true
                        type: object
                    type: object
                - $ref: '#/components/schemas/vectorize_api-response-common-failure'
          description: Create Vectorize Index Failure Response
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/vectorize_api-response-single'
                - properties:
                    result:
                      $ref: '#/components/schemas/vectorize_create-index-response'
          description: Create Vectorize Index Response
      security:
      - api_token: []
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform Create Vectorize Index
      tags:
      - Vectorize
      x-api-token-group:
      - Vectorize Write
      x-cfPermissionsRequired:
        enum:
        - com.cloudflare.edge.vectorize.index.create
  /accounts/{account_id}/vectorize/v2/indexes/{index_name}:
    delete:
      description: Deletes the specified Vectorize Index.
      operationId: vectorize-delete-vectorize-index
      parameters:
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/vectorize_identifier'
      - in: path
        name: index_name
        required: true
        schema:
          $ref: '#/components/schemas/vectorize_index-name'
      responses:
        4XX:
          content:
            application/json:
              schema:
                allOf:
                - allOf:
                  - $ref: '#/components/schemas/vectorize_api-response-single'
                  - properties:
                      result:
                        nullable: true
                        type: object
                    type: object
                - $ref: '#/components/schemas/vectorize_api-response-common-failure'
          description: Delete Vectorize Index Failure
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/vectorize_api-response-single'
                - properties:
                    result:
                      nullable: true
                      type: object
          description: Delete Vectorize Index Response
      security:
      - api_token: []
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform Delete Vectorize Index
      tags:
      - Vectorize
      x-api-token-group:
      - Vectorize Write
      x-cfPermissionsRequired:
        enum:
        - com.cloudflare.edge.vectorize.index.delete
    get:
      description: Returns the specified Vectorize Index.
      operationId: vectorize-get-vectorize-index
      parameters:
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/vectorize_identifier'
      - in: path
        name: index_name
        required: true
        schema:
          $ref: '#/components/schemas/vectorize_index-name'
      responses:
        4XX:
          content:
            application/json:
              schema:
                allOf:
                - allOf:
                  - $ref: '#/components/schemas/vectorize_api-response-single'
                  - properties:
                      result:
                        nullable: true
                        type: object
                    type: object
                - $ref: '#/components/schemas/vectorize_api-response-common-failure'
          description: Get Vectorize Index Failure
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/vectorize_api-response-single'
                - properties:
                    result:
                      $ref: '#/components/schemas/vectorize_create-index-response'
          description: Get Vectorize Index Response
      security:
      - api_token: []
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform Get Vectorize Index
      tags:
      - Vectorize
      x-api-token-group:
      - Vectorize Write
      - Vectorize Read
      x-cfPermissionsRequired:
        enum:
        - com.cloudflare.edge.vectorize.index.read
  /accounts/{account_id}/vectorize/v2/indexes/{index_name}/delete_by_ids:
    post:
      description: Delete a set of vectors from an index by their vector identifiers.
      operationId: vectorize-delete-vectors-by-id
      parameters:
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/vectorize_identifier'
      - in: path
        name: index_name
        required: true
        schema:
          $ref: '#/components/schemas/vectorize_index-name'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/vectorize_index-delete-vectors-by-id-request'
        required: true
      responses:
        4XX:
          content:
            application/json:
              schema:
                allOf:
                - allOf:
                  - $ref: '#/components/schemas/vectorize_api-response-single'
                  - properties:
                      result:
                        nullable: true
                        type: object
                    type: object
                - $ref: '#/components/schemas/vectorize_api-response-common-failure'
          description: Delete Vector Identifiers Failure Response
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/vectorize_api-response-single'
                - properties:
                    result:
                      $ref: '#/components/schemas/vectorize_index-delete-vectors-by-id-v2-response'
          description: Delete Vector Identifiers Response
      security:
      - api_token: []
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform Delete Vectors By Identifier
      tags:
      - Vectorize
      x-api-token-group:
      - Vectorize Write
      x-cfPermissionsRequired:
        enum:
        - com.cloudflare.edge.vectorize.index.delete
  /accounts/{account_id}/vectorize/v2/indexes/{index_name}/get_by_ids:
    post:
      description: Get a set of vectors from an index by their vector identifiers.
      operationId: vectorize-get-vectors-by-id
      parameters:
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/vectorize_identifier'
      - in: path
        name: index_name
        required: true
        schema:
          $ref: '#/components/schemas/vectorize_index-name'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/vectorize_index-get-vectors-by-id-request'
        required: true
      responses:
        4XX:
          content:
            application/json:
              schema:
                allOf:
                - allOf:
                  - $ref: '#/components/schemas/vectorize_api-response-single'
                  - properties:
                      result:
                        nullable: true
                        type: object
                    type: object
                - $ref: '#/components/schemas/vectorize_api-response-common-failure'
          description: Get Vectors By Identifier Failure Response
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/vectorize_api-response-single'
                - properties:
                    result:
                      $ref: '#/components/schemas/vectorize_index-get-vectors-by-id-response'
          description: Get Vectors By Identifier Response
      security:
      - api_token: []
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform Get Vectors By Identifier
      tags:
      - Vectorize
      x-cfPermissionsRequired:
        enum:
        - com.cloudflare.edge.vectorize.index.read
  /accounts/{account_id}/vectorize/v2/indexes/{index_name}/info:
    get:
      description: Get information about a vectorize index.
      operationId: vectorize-index-info
      parameters:
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/vectorize_identifier'
      - in: path
        name: index_name
        required: true
        schema:
          $ref: '#/components/schemas/vectorize_index-name'
      responses:
        4XX:
          content:
            application/json:
              schema:
                allOf:
                - allOf:
                  - $ref: '#/components/schemas/vectorize_api-response-single'
                  - properties:
                      result:
                        nullable: true
                        type: object
                    type: object
                - $ref: '#/components/schemas/vectorize_api-response-common-failure'
          description: Get Vectorize Index Info Failure Response
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/vectorize_api-response-single'
                - properties:
                    result:
                      $ref: '#/components/schemas/vectorize_index-info-response'
          description: Get Vectorize Index Info Response
      security:
      - api_token: []
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform Get Vectorize Index Info
      tags:
      - Vectorize
      x-api-token-group:
      - Vectorize Write
      - Vectorize Read
      x-cfPermissionsRequired:
        enum:
        - com.cloudflare.edge.vectorize.index.read
  /accounts/{account_id}/vectorize/v2/indexes/{index_name}/insert:
    post:
      description: Inserts vectors into the specified index and returns a mutation id corresponding to the vectors enqueued for insertion.
      operationId: vectorize-insert-vector
      parameters:
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/vectorize_identifier'
      - in: path
        name: index_name
        required: true
        schema:
          $ref: '#/components/schemas/vectorize_index-name'
      - in: query
        name: unparsable-behavior
        schema:
          description: Behavior for ndjson parse failures.
          enum:
          - error
          - discard
          type: string
      requestBody:
        content:
          application/x-ndjson:
            schema:
              description: ndjson file containing vectors to insert.
              example: '@/path/to/vectors.ndjson'
              format: binary
              type: string
        required: true
      responses:
        4XX:
          content:
            application/json:
              schema:
                allOf:
                - allOf:
                  - $ref: '#/components/schemas/vectorize_api-response-single'
                  - properties:
                      result:
                        nullable: true
                        type: object
                    type: object
                - $ref: '#/components/schemas/vectorize_api-response-common-failure'
          description: Insert Vectors Failure Response
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/vectorize_api-response-single'
                - properties:
                    result:
                      $ref: '#/components/schemas/vectorize_index-insert-v2-response'
          description: Insert Vectors Response
      security:
      - api_token: []
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform Insert Vectors
      tags:
      - Vectorize
      x-cfPermissionsRequired:
        enum:
        - com.cloudflare.edge.vectorize.index.update
  /accounts/{account_id}/vectorize/v2/indexes/{index_name}/metadata_index/create:
    post:
      description: Enable metadata filtering based on metadata property. Limited to 10 properties.
      operationId: vectorize-create-metadata-index
      parameters:
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/vectorize_identifier'
      - in: path
        name: index_name
        required: true
        schema:
          $ref: '#/components/schemas/vectorize_index-name'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/vectorize_create-metadata-index-request'
        required: true
      responses:
        4XX:
          content:
            application/json:
              schema:
                allOf:
                - allOf:
                  - $ref: '#/components/schemas/vectorize_api-response-single'
                  - properties:
                      result:
                        nullable: true
                        type: object
                    type: object
                - $ref: '#/components/schemas/vectorize_api-response-common-failure'
          description: Create Metadata Index Failure Response
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/vectorize_api-response-single'
                - properties:
                    result:
                      $ref: '#/components/schemas/vectorize_create-metadata-index-response'
          description: Create Metadata Index Response
      security:
      - api_token: []
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform Create Metadata Index
      tags:
      - Vectorize
      x-api-token-group:
      - Vectorize Write
      x-cfPermissionsRequired:
        enum:
        - com.cloudflare.edge.vectorize.index.create
  /accounts/{account_id}/vectorize/v2/indexes/{index_name}/metadata_index/delete:
    post:
      description: Allow Vectorize to delete the specified metadata index.
      operationId: vectorize-delete-metadata-index
      parameters:
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/vectorize_identifier'
      - in: path
        name: index_name
        required: true
        schema:
          $ref: '#/components/schemas/vectorize_index-name'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/vectorize_delete-metadata-index-request'
        required: true
      responses:
        4XX:
          content:
            application/json:
              schema:
                allOf:
                - allOf:
                  - $ref: '#/components/schemas/vectorize_api-response-single'
                  - properties:
                      result:
                        nullable: true
                        type: object
                    type: object
                - $ref: '#/components/schemas/vectorize_api-response-common-failure'
          description: Delete Metadata Index Failure
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/vectorize_api-response-single'
                - properties:
                    result:
                      $ref: '#/components/schemas/vectorize_delete-metadata-index-response'
          description: Delete Metadata Index Response
      security:
      - api_token: []
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform Delete Metadata Index
      tags:
      - Vectorize
      x-api-token-group:
      - Vectorize Write
      x-cfPermissionsRequired:
        enum:
        - com.cloudflare.edge.vectorize.index.delete
  /accounts/{account_id}/vectorize/v2/indexes/{index_name}/metadata_index/list:
    get:
      description: List Metadata Indexes for the specified Vectorize Index.
      operationId: vectorize-list-metadata-indexes
      parameters:
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/vectorize_identifier'
      - in: path
        name: index_name
        required: true
        schema:
          $ref: '#/components/schemas/vectorize_index-name'
      responses:
        4XX:
          content:
            application/json:
              schema:
                allOf:
                - allOf:
                  - $ref: '#/components/schemas/vectorize_api-response-single'
                  - properties:
                      result:
                        nullable: true
                        type: object
                    type: object
                - $ref: '#/components/schemas/vectorize_api-response-common-failure'
          description: List Metadata Index Failure Response
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/vectorize_api-response-single'
                - properties:
                    result:
                      $ref: '#/components/schemas/vectorize_list-metadata-index-response'
          description: List Metadata Index Response
      security:
      - api_token: []
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform List Metadata Indexes
      tags:
      - Vectorize
      x-cfPermissionsRequired:
        enum:
        - com.cloudflare.edge.vectorize.index.list
  /accounts/{account_id}/vectorize/v2/indexes/{index_name}/query:
    post:
      description: Finds vectors closest to a given vector in an index.
      operationId: vectorize-query-vector
      parameters:
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/vectorize_identifier'
      - in: path
        name: index_name
        required: true
        schema:
          $ref: '#/components/schemas/vectorize_index-name'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/vectorize_index-query-v2-request'
        required: true
      responses:
        4XX:
          content:
            application/json:
              schema:
                allOf:
                - allOf:
                  - $ref: '#/components/schemas/vectorize_api-response-single'
                  - properties:
                      result:
                        nullable: true
                        type: object
                    type: object
                - $ref: '#/components/schemas/vectorize_api-response-common-failure'
          description: Query Vectors Failure Response
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/vectorize_api-response-single'
                - properties:
                    result:
                      $ref: '#/components/schemas/vectorize_index-query-v2-response'
          description: Query Vectors Response
      security:
      - api_token: []
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform Query Vectors
      tags:
      - Vectorize
      x-cfPermissionsRequired:
        enum:
        - com.cloudflare.edge.vectorize.index.read
  /accounts/{account_id}/vectorize/v2/indexes/{index_name}/upsert:
    post:
      description: Upserts vectors into the specified index, creating them if they do not exist and returns a mutation id corresponding to the vectors enqueued for upsertion.
      operationId: vectorize-upsert-vector
      parameters:
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/vectorize_identifier'
      - in: path
        name: index_name
        required: true
        schema:
          $ref: '#/components/schemas/vectorize_index-name'
      - in: query
        name: unparsable-behavior
        schema:
          description: Behavior for ndjson parse failures.
          enum:
          - error
          - discard
          type: string
      requestBody:
        content:
          application/x-ndjson:
            schema:
              description: ndjson file containing vectors to upsert.
              example: '@/path/to/vectors.ndjson'
              format: binary
              type: string
        required: true
      responses:
        4XX:
          content:
            application/json:
              schema:
                allOf:
                - allOf:
                  - $ref: '#/components/schemas/vectorize_api-response-single'
                  - properties:
                      result:
                        nullable: true
                        type: object
                    type: object
                - $ref: '#/components/schemas/vectorize_api-response-common-failure'
          description: Upsert Vectors Failure Response
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/vectorize_api-response-single'
                - properties:
                    result:
                      $ref: '#/components/schemas/vectorize_index-upsert-v2-response'
          description: Upsert Vectors Response
      security:
      - api_token: []
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform Upsert Vectors
      tags:
      - Vectorize
      x-cfPermissionsRequired:
        enum:
        - com.cloudflare.edge.vectorize.index.update
components:
  schemas:
    vectorize_index-delete-vectors-by-id-v2-response:
      properties:
        mutationId:
          $ref: '#/components/schemas/vectorize_mutation-uuid'
      type: object
    vectorize_mutation-uuid:
      description: The unique identifier for the async mutation operation containing the changeset.
      example: 0000aaaa-11bb-22cc-33dd-444444eeeeee
      maxLength: 36
    vectorize_create-metadata-index-request:
      properties:
        indexType:
          description: Specifies the type of metadata property to index.
          enum:
          - string
          - number
          - boolean
          type: string
        propertyName:
          description: Specifies the metadata property to index.
          example: random_metadata_property
          type: string
      required:
      - propertyName
      - indexType
      type: object
    vectorize_api-response-common:
      properties:
        errors:
          $ref: '#/components/schemas/vectorize_messages'
        messages:
          $ref: '#/components/schemas/vectorize_messages'
        result:
          anyOf:
          - type: object
          - items: {}
            type: array
          - type: string
        success:
          description: Whether the API call was successful
          enum:
          - true
          example: true
          type: boolean
      required:
      - success
      - errors
      - messages
      - result
      type: object
    vectorize_index-query-v2-response:
      properties:
        count:
          description: Specifies the count of vectors returned by the search
          type: integer
        matches:
          description: Array of vectors matched by the search
          items:
            properties:
              id:
                $ref: '#/components/schemas/vectorize_vector-identifier'
              metadata:
                nullable: true
                type: object
              namespace:
                nullable: true
                type: string
              score:
                description: The score of the vector according to the index's distance metric
                type: number
              values:
                items:
                  type: number
                nullable: true
                type: array
            type: object
          type: array
      type: object
    vectorize_index-query-v2-request:
      properties:
        filter:
          description: A metadata filter expression used to limit nearest neighbor results.
          example:
            has_viewed:
              $ne: true
            streaming_platform: netflix
          type: object
        returnMetadata:
          default: none
          description: Whether to return no metadata, indexed metadata or all metadata associated with the closest vectors.
          enum:
          - none
          - indexed
          - all
          type: string
        returnValues:
          default: false
          description: Whether to return the values associated with the closest vectors.
          type: boolean
        topK:
          default: 5
          description: The number of nearest neighbors to find.
          example: 5
          type: number
        vector:
          description: The search vector that will be used to find the nearest neighbors.
          example:
          - 0.5
          - 0.5
          - 0.5
          items:
            type: number
          type: array
      required:
      - vector
      type: object
    vectorize_index-delete-vectors-by-id-request:
      properties:
        ids:
          description: A list of vector identifiers to delete from the index indicated by the path.
          example:
          - 5121db81354a40c6aedc3fe1ace51c59
          - f90eb49c2107486abdfd78c67e853430
          items:
            $ref: '#/components/schemas/vectorize_vector-identifier'
          type: array
      type: object
    vectorize_index-get-vectors-by-id-response:
      description: Array of vectors with matching ids.
      example:
      - id: some-vector-id
        metadata:
          another-key: another-value
          customer-id: 442
        values:
        - 0.812
        - 0.621
        - 0.261
      - id: other-vector-id
        metadata:
          another-key: with-a-value
          customer-id: 2151
        namespace: namespaced
        values:
        - 0.961
        - 0.751
        - 0.661
      items:
        properties:
          id:
            $ref: '#/components/schemas/vectorize_vector-identifier'
          metadata:
            type: object
          namespace:
            nullable: true
            type: string
          values:
            items:
              type: number
            type: array
        type: object
      type: array
    vectorize_index-dimensions:
      description: Specifies the number of dimensions for the index
      example: 768
      maximum: 1536
      minimum: 1
      type: integer
    vectorize_a

# --- truncated at 32 KB (39 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/apis-io-engineering-platform/refs/heads/main/openapi/engineering-platform-vectorize-api-openapi.yml