---
title: "Update Collection Queryables"
method: PUT
path: "/stac/collections/{collectionId}/queryables/{queryableName}"
tags: ["STAC Collection Configuration"]
---

# Update Collection Queryables

`PUT /stac/collections/{collectionId}/queryables/{queryableName}`

Updates a queryable given a queryable definition and
corresponding collection id.

## Path parameters

- `collectionId` string, required
- `queryableName` string, required

## Query parameters

- `api-version` string, required

## Request body

- StacQueryable — Definition of a queryable field for STAC API filtering.
  - `name` string, required — Name of the queryable field.
  - `definition` object, required — Metadata for the queryable field.
  - `create_index` boolean — Whether to create a database index for this field.
  - `data_type` 'string' | 'number' | 'boolean' | 'timestamp' | 'date' — Data type of the queryable field.

## Response `200`

The request has succeeded.

- StacQueryable — Definition of a queryable field for STAC API filtering.
  - `name` string, required — Name of the queryable field.
  - `definition` object, required — Metadata for the queryable field.
  - `create_index` boolean — Whether to create a database index for this field.
  - `data_type` 'string' | 'number' | 'boolean' | 'timestamp' | 'date' — Data type of the queryable field.

## Other responses

- `default` — An unexpected error response.

## Changes

- **2026-02-19** (2025-04-30-preview) `28e8cb365289` — 1 breaking, 1 info
  - removed the success response with the status `201`
  - api operation id `StacQueryables_CreateOrReplace` removed and replaced with `StacQueryables_Replace`
- **2025-05-15** (2025-04-30-preview) `00cbc3d6d8e0` — 2 info
  - api operation id `StacQueryables_Replace` removed and replaced with `StacQueryables_CreateOrReplace`
  - added the success response with the status `201`

[Change history](https://skmtc.dev/azure/apis/orbital-microsoft-planetarycomputer/changes/stac/collections/:collectionId/queryables/:queryableName/put.md)

---

[API](https://skmtc.dev/azure/apis/orbital-microsoft-planetarycomputer.md) · [All operations](https://skmtc.dev/azure/apis/orbital-microsoft-planetarycomputer/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/orbital-microsoft-planetarycomputer/revisions/42447be18bc5/schema)