openapi: 3.0.2
info:
  title: Search API
  description: API powering the Search feature of Algolia.
  version: 0.1.0
components:
  securitySchemes:
    appId:
      $ref: '../common/securitySchemes.yml#/appId'
    apiKey:
      $ref: '../common/securitySchemes.yml#/apiKey'
security:
  - appId: []
    apiKey: []
paths:
  # ########################
  # ### Search Endpoints ###
  # ########################
  /1/indexes/{indexName}/query:
    $ref: './paths/search/search.yml'
  /1/indexes/*/queries:
    $ref: './paths/search/multipleQueries.yml'
  # /1/indexes/{indexName}/facets/{facetName}/query:
  #  $ref: './paths/search/searchForFacetValues.yml'
  # /1/indexes/{indexName}/browse:
  #  $ref: './paths/search/browse.yml'

  # #########################
  # ### Objects Endpoints ###
  # #########################
  /1/indexes/{indexName}:
    $ref: './paths/objects/objects.yml'
  # /1/indexes/{indexName}/{objectID}:
  #   $ref: './paths/objects/object.yml'
  # /1/indexes/{indexName}/deleteByQuery:
  #   $ref: './paths/objects/deleteBy.yml'
  # /1/indexes/{indexName}/clear:
  #   $ref: './paths/objects/clearObjects.yml'
  # /1/indexes/{indexName}/{objectID}/partial:
  #   $ref: './paths/objects/partialUpdate.yml'
  /1/indexes/{indexName}/batch:
    $ref: './paths/objects/batch.yml'
  # /1/indexes/*/batch:
  #   $ref: './paths/objects/multipleBatch.yml'
  # /1/indexes/*/objects:
  #   $ref: './paths/objects/multipleGetObjects.yml'
  # /1/indexes/{indexName}/{objectID}:
  #   $ref: './paths/objects/getObject.yml'

  # ##########################
  # ### Settings Endpoints ###
  # ##########################
  /1/indexes/{indexName}/settings:
    $ref: './paths/settings/settings.yml'

  # ##########################
  # ### Synonyms Endpoints ###
  # ##########################
  # /1/indexes/{indexName}/synonyms/{objectID}:
  #   $ref: './paths/synonyms/synonym.yml'
  # /1/indexes/{indexName}/synonyms/batch:
  #   $ref: './paths/synonyms/batchSynonyms.yml'
  # /1/indexes/{indexName}/synonyms/clear:
  #   $ref: './paths/synonyms/clearAllSynonyms.yml'
  # /1/indexes/{indexName}/synonyms/search:
  #   $ref: './paths/synonyms/searchSynonyms.yml'

  # ######################
  # ### Keys Endpoints ###
  # ######################
  # /1/keys:
  #   $ref: './paths/keys/keys.yml'
  # /1/keys/{key}:
  #   $ref: './paths/keys/key.yml'
  # /1/keys/{key}/restore:
  #   $ref: './paths/keys/restoreApiKey.yml'

  # #######################
  # ### Rules Endpoints ###
  # #######################
  # /1/indexes/{indexName}/rules/{objectID}:
  #   $ref: './paths/rules/rule.yml'
  # /1/indexes/{indexName}/rules/batch:
  #   $ref: './paths/rules/batchRules.yml'
  # /1/indexes/{indexName}/rules/clear:
  #   $ref: './paths/rules/clearRules.yml'
  # /1/indexes/{indexName}/rules/search:
  #   $ref: './paths/rules/searchRules.yml'

  # ##############################
  # ### Dictionaries Endpoints ###
  # ##############################
  # /1/dictionaries/{dictionaryName}/batch:
  #   $ref: './paths/dictionaries/batchDictionaryEntries.yml'
  # /1/dictionaries/{dictionaryName}/search:
  #   $ref: './paths/dictionaries/searchDictionaryEntries.yml'
  # /1/dictionaries/*/settings:
  #   $ref: './paths/dictionaries/dictionarySettings.yml'
  # /1/dictionaries/*/languages:
  #   $ref: './paths/dictionaries/getDictionaryLanguages.yml'

  # ###############################
  # ### MultiClusters Endpoints ###
  # ###############################
  # /1/clusters/mapping:
  #   $ref: './paths/multiclusters/userIds.yml'
  # /1/clusters/mapping/batch:
  #   $ref: './paths/multiclusters/batchAssignUserIds.yml'
  # /1/clusters/mapping/top:
  #   $ref: './paths/multiclusters/getTopUserIds.yml'
  # /1/clusters/mapping/{userID}:
  #   $ref: './paths/multiclusters/userId.yml'
  # /1/clusters:
  #   $ref: './paths/multiclusters/listClusters.yml'
  # /1/clusters/mapping/search:
  #   $ref: './paths/multiclusters/searchUserIds.yml'
  # /1/clusters/mapping/pending:
  #   $ref: './paths/multiclusters/hasPendingMappings.yml'

  # #######################
  # ### Vault Endpoints ###
  # #######################
  # /1/security/sources:
  #   $ref: './paths/vault/vaultSources.yml'
  # /1/security/sources/append:
  #   $ref: './paths/vault/appendSource.yml'
  # /1/security/sources/{source}:
  #   $ref: './paths/vault/deleteSource.yml'

  # ##########################
  # ### Advanced Endpoints ###
  # ##########################
  # /1/logs:
  #   $ref: './paths/advanced/getLogs.yml'
  # /1/indexes/{indexName}/task/{taskID}:
  #   $ref: './paths/advanced/getTask.yml'
  # /1/isalive:
  #   $ref: './paths/advanced/isAlive.yml'

  # ################################
  # ### Manage Indices Endpoints ###
  # ################################
  /1/indexes/{indexName}/operation:
    $ref: './paths/manage_indices/operationIndex.yml'
  /1/indexes:
    $ref: './paths/manage_indices/listIndices.yml'