---
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}`

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.net/office-of-national-statistics/apis/dimension-search-api.md) · [All operations](https://skmtc.net/office-of-national-statistics/apis/dimension-search-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/office-of-national-statistics/dimension-search-api/revisions/372166ddce1a/schema)
