# Azure AI Search API

**Canonical:** https://apis.io/apis/azure-ai-search/azure-ai-search-api/  
**Provider:** Azure AI Search — https://apis.io/providers/azure-ai-search/  
**Base URL:** https://management.azure.com  
**Documentation:** https://learn.microsoft.com/en-us/rest/api/searchservice/common-http-request-and-response-headers-used-in-azure-search

Azure AI Search API is one of 2 APIs that [Azure AI Search](https://apis.io/providers/azure-ai-search/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Azure AI Search API as documented publicly: 14 operations. Contract generated from the documentation by API Evangelist (2026-10-13); not the provider's own document.

## Operations (14)

| Method | Path | Summary |
|---|---|---|
| GET | `/` | GET / |
| POST | `/indexes` | Common HTTP request and response headers (Azure AI Search) |
| PUT | `/indexes` | Common HTTP request and response headers (Azure AI Search) |
| GET | `/indexes/my-new-index/docs` | Query an index |
| POST | `/subscriptions/{subscriptionid}/resourceGroups/{resourcegroupname}/providers/Microsoft.Search/searchServices/{searchservicename}/createQueryKey/{name}` | Create Query Keys in the Management REST API |
| POST | `/subscriptions/{subscriptionid}/resourceGroups/{resourceGroup}/providers//Microsoft.Search/searchServices/{searchServiceName}/listAdminKeys` | Return admin keys |
| GET | `/swagger/v1/swagger.json` | GET /swagger/v1/swagger.json |
| GET | `/todoitems` | Get all to-do items |
| POST | `/todoitems` | Add a new item |
| DELETE | `/todoitems/{id}` | Delete an item |
| GET | `/todoitems/{id}` | Get an item by ID |
| PATCH | `/todoitems/{id}` | Partially update an item |
| PUT | `/todoitems/{id}` | Update an existing item |
| GET | `/weatherforecast` | GetWeatherForecast |

## Machine-readable artifacts (7)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/azure-ai-search/refs/heads/main/openapi/_ae-authored/azure-ai-search-openapi-generated.yml
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/azure-ai-search/refs/heads/main/json-schema/azure-ai-search-get-swagger-v1-swagger-json-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/azure-ai-search/refs/heads/main/json-schema/azure-ai-search-patch-todoitems-id-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/azure-ai-search/refs/heads/main/json-schema/azure-ai-search-get-weatherforecast-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/azure-ai-search/refs/heads/main/json-schema/azure-ai-search-post-todoitems-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/azure-ai-search/refs/heads/main/json-schema/azure-ai-search-put-todoitems-id-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/azure-ai-search/refs/heads/main/json-schema/azure-ai-search-get-response-schema.json

## Other Azure AI Search APIs (1)

- [Azure AI Search API](https://apis.io/apis/azure-ai-search/azure-ai-search-api-2/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/azure-ai-search/azure-ai-search-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/azure-ai-search/.