---
title: "Create a search index"
method: PUT
path: "/dimension-search/instances/{instance_id}/dimensions/{name}"
tags: ["Private user"]
---

# Create a search index

`PUT /dimension-search/instances/{instance_id}/dimensions/{name}`

## Request

- Base URL: `/v1` (relative, and the document’s source URL is not known)
- URL: `/v1/dimension-search/instances/{instance_id}/dimensions/{name}`
- Auth: none declared

Create a search index containing a list of dimension options for an instance

## Path parameters

- `instance_id` string, required
- `name` string, required

## Response `200`

The index was created

## Other responses

- `404`: Dimension or option not found.
- `500`: Failed to process the request due to an internal error.

---

[API](https://skmtc.dev/office-of-national-statistics/apis/dimension-search-api.md) - [All operations](https://skmtc.dev/office-of-national-statistics/apis/dimension-search-api/llms.txt) - [OpenAPI document](https://skmtc.dev/office-of-national-statistics/apis/dimension-search-api/revisions/372166ddce1a?raw)