---
title: "Create a Dimension"
method: POST
path: "/v1/dimensions/create"
tags: ["Dimension"]
---

# Create a Dimension

`POST /v1/dimensions/create`

Create Dimension.

## Request body

- DimensionDefinition
  - `sysId` string — Identifier of the definition
  - `createdOn` string, date-time — Definition created on
  - `updatedOn` string, date-time — Definition updated on
  - `headVersion` RecordIdentity
    - `sysId` string — Unique Identifier of the tracked item
    - `lastUpdate` string, date-time — Last update of the tracked item
    - `table` string — Context of the tracked item
  - `releaseVersion` RecordIdentity
    - `sysId` string — Unique Identifier of the tracked item
    - `lastUpdate` string, date-time — Last update of the tracked item
    - `table` string — Context of the tracked item
  - `owner` string — Owner of the dimension definition
  - `is_active` boolean, required — States if the Dimension Definition is active or not
  - `name` string, required — Name of the Dimension Definition
  - `description` string — Description of Dimension Definition
  - `master_account_id` string — Master account ID
  - `source` 'Billing', required — Source of Dimension Definition
  - `dimension_type` 'AccountGroup' | 'Custom' | 'Lens' | 'Service' | 'VirtualTags', required — Type of Dimension Definition
  - `dimension_template_type` 'Custom' | 'Default' | 'Global', required — Type of Dimension Definition Template Used
  - `is_cost_anomaly_detection_enabled` boolean — If True, Cost Anomaly Detection will be enabled for all grouping rules under this Dimension

## Response `200`

Created successfully

- DimensionDefinition
  - `sysId` string — Identifier of the definition
  - `createdOn` string, date-time — Definition created on
  - `updatedOn` string, date-time — Definition updated on
  - `headVersion` RecordIdentity
    - `sysId` string — Unique Identifier of the tracked item
    - `lastUpdate` string, date-time — Last update of the tracked item
    - `table` string — Context of the tracked item
  - `releaseVersion` RecordIdentity
    - `sysId` string — Unique Identifier of the tracked item
    - `lastUpdate` string, date-time — Last update of the tracked item
    - `table` string — Context of the tracked item
  - `owner` string — Owner of the dimension definition
  - `is_active` boolean, required — States if the Dimension Definition is active or not
  - `name` string, required — Name of the Dimension Definition
  - `description` string — Description of Dimension Definition
  - `master_account_id` string — Master account ID
  - `source` 'Billing', required — Source of Dimension Definition
  - `dimension_type` 'AccountGroup' | 'Custom' | 'Lens' | 'Service' | 'VirtualTags', required — Type of Dimension Definition
  - `dimension_template_type` 'Custom' | 'Default' | 'Global', required — Type of Dimension Definition Template Used
  - `is_cost_anomaly_detection_enabled` boolean — If True, Cost Anomaly Detection will be enabled for all grouping rules under this Dimension

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `500` — Internal Server Error

---

[API](https://skmtc.dev/corestack/apis/corestack-external-api.md) · [All operations](https://skmtc.dev/corestack/apis/corestack-external-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/corestack/corestack-external-api/revisions/bf2cdf20826d/schema)